WebClient.OpenWrite Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Öppnar en dataström för att skriva data till en resurs med angiven URI.
Överlagringar
| Name | Description |
|---|---|
| OpenWrite(String) |
Öppnar en ström för att skriva data till den angivna resursen. |
| OpenWrite(Uri) |
Öppnar en ström för att skriva data till den angivna resursen. |
| OpenWrite(String, String) |
Öppnar en ström för att skriva data till den angivna resursen med den angivna metoden. |
| OpenWrite(Uri, String) |
Öppnar en dataström för att skriva data till den angivna resursen med hjälp av den angivna metoden. |
OpenWrite(String)
Öppnar en ström för att skriva data till den angivna resursen.
public:
System::IO::Stream ^ OpenWrite(System::String ^ address);
public System.IO.Stream OpenWrite(string address);
member this.OpenWrite : string -> System.IO.Stream
Public Function OpenWrite (address As String) As Stream
Parametrar
- address
- String
Resursens URI för att ta emot data.
Returer
En Stream som används för att skriva data till resursen.
Undantag
Parametern address är null.
Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.
-eller-
Ett fel uppstod när strömmen öppnades.
Exempel
I följande kodexempel läss data från kommandoraden och används OpenWrite för att hämta en dataström för att skriva data. Den Stream som returneras av OpenWrite stängs efter att data har skickats.
String^ uriString;
Console::Write( "\nPlease enter the URI to post data to: " );
uriString = Console::ReadLine();
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply Ascii Encoding to obtain an array of bytes.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// postStream implicitly sets HTTP POST as the request method.
Console::WriteLine( "Uploading to {0} ...", uriString );
Stream^ postStream = myWebClient->OpenWrite( uriString );
postStream->Write( postArray, 0, postArray->Length );
// Close the stream and release resources.
postStream->Close();
Console::WriteLine( "\nSuccessfully posted the data." );
string uriString;
Console.Write("\nPlease enter the URI to post data to : ");
uriString = Console.ReadLine();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply Ascii Encoding to obtain an array of bytes.
byte[] postArray = Encoding.ASCII.GetBytes(postData);
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// postStream implicitly sets HTTP POST as the request method.
Console.WriteLine("Uploading to {0} ...", uriString); Stream postStream = myWebClient.OpenWrite(uriString);
postStream.Write(postArray,0,postArray.Length);
// Close the stream and release resources.
postStream.Close();
Console.WriteLine("\nSuccessfully posted the data.");
Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
uriString = Console.ReadLine()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
' Apply ASCII Encoding to obtain an array of bytes .
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine("Uploading to {0} ...", uriString)
' OpenWrite implicitly sets HTTP POST as the request method.
Dim postStream As Stream = myWebClient.OpenWrite(uriString)
postStream.Write(postArray, 0, postArray.Length)
' Close the stream and release resources.
postStream.Close()
Console.WriteLine(ControlChars.Cr + "Successfully posted the data.")
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Metoden OpenWrite returnerar en skrivbar ström som används för att skicka data till en resurs. Den här metoden blockerar när strömmen öppnas. Om du vill fortsätta köra i väntan på dataströmmen använder du någon av OpenWriteAsync metoderna.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Den här metoden använder STOR-kommandot för att ladda upp en FTP-resurs. För en HTTP-resurs används POST-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
Gäller för
OpenWrite(Uri)
Öppnar en ström för att skriva data till den angivna resursen.
public:
System::IO::Stream ^ OpenWrite(Uri ^ address);
public System.IO.Stream OpenWrite(Uri address);
member this.OpenWrite : Uri -> System.IO.Stream
Public Function OpenWrite (address As Uri) As Stream
Parametrar
- address
- Uri
Resursens URI för att ta emot data.
Returer
En Stream som används för att skriva data till resursen.
Undantag
Parametern address är null.
Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.
-eller-
Ett fel uppstod när strömmen öppnades.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Metoden OpenWrite returnerar en skrivbar ström som används för att skicka data till en resurs. Den här metoden blockerar när strömmen öppnas. Om du vill fortsätta köra i väntan på dataströmmen använder du någon av OpenWriteAsync metoderna.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Den här metoden använder STOR-kommandot för att ladda upp en FTP-resurs. För en HTTP-resurs används POST-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
Gäller för
OpenWrite(String, String)
Öppnar en ström för att skriva data till den angivna resursen med den angivna metoden.
public:
System::IO::Stream ^ OpenWrite(System::String ^ address, System::String ^ method);
public System.IO.Stream OpenWrite(string address, string method);
member this.OpenWrite : string * string -> System.IO.Stream
Public Function OpenWrite (address As String, method As String) As Stream
Parametrar
- address
- String
Resursens URI för att ta emot data.
- method
- String
Den metod som används för att skicka data till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.
Returer
En Stream som används för att skriva data till resursen.
Undantag
Parametern address är null.
Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.
-eller-
Ett fel uppstod när strömmen öppnades.
Exempel
I följande kodexempel läss data från kommandoraden och används OpenWrite för att hämta en dataström som används för att skriva data. Den Stream som returneras av OpenWrite måste stängas för att skicka data.
String^ uriString;
Console::Write( "\nPlease enter the URI to post data to: " );
uriString = Console::ReadLine();
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII encoding to obtain an array of bytes .
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "Uploading to {0} ...", uriString );
Stream^ postStream = myWebClient->OpenWrite( uriString, "POST" );
postStream->Write( postArray, 0, postArray->Length );
// Close the stream and release resources.
postStream->Close();
Console::WriteLine( "\nSuccessfully posted the data." );
string uriString;
Console.Write("\nPlease enter the URI to post data to : ");
uriString = Console.ReadLine();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply ASCII encoding to obtain an array of bytes .
byte[] postArray = Encoding.ASCII.GetBytes(postData);
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
Console.WriteLine("Uploading to {0} ...", uriString);
Stream postStream = myWebClient.OpenWrite(uriString,"POST");
postStream.Write(postArray,0,postArray.Length);
// Close the stream and release resources.
postStream.Close();
Console.WriteLine("\nSuccessfully posted the data.");
Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
uriString = Console.ReadLine()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
' Apply ASCII encoding to obtain an array of bytes.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine("Uploading to {0} ...", uriString)
Dim postStream As Stream = myWebClient.OpenWrite(uriString, "POST")
postStream.Write(postArray, 0, postArray.Length)
' Close the stream and release resources.
postStream.Close()
Console.WriteLine(ControlChars.Cr + "Successfully posted the data.")
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Metoden OpenWrite returnerar en skrivbar ström som används för att skicka data till en resurs. Den underliggande begäran görs med den metod som anges i parametern method . Data skickas till servern när du stänger strömmen. Den här metoden blockerar när strömmen öppnas. Om du vill fortsätta köra i väntan på dataströmmen använder du någon av OpenWriteAsync metoderna.
Om parametern method anger en metod som inte förstås av servern avgör de underliggande protokollklasserna vad som händer. Vanligtvis genereras en WebException med egenskapen Status inställd för att indikera felet.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte anger en absolut adress, address måste vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
Gäller för
OpenWrite(Uri, String)
Öppnar en dataström för att skriva data till den angivna resursen med hjälp av den angivna metoden.
public:
System::IO::Stream ^ OpenWrite(Uri ^ address, System::String ^ method);
public System.IO.Stream OpenWrite(Uri address, string method);
member this.OpenWrite : Uri * string -> System.IO.Stream
Public Function OpenWrite (address As Uri, method As String) As Stream
Parametrar
- address
- Uri
Resursens URI för att ta emot data.
- method
- String
Den metod som används för att skicka data till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.
Returer
En Stream som används för att skriva data till resursen.
Undantag
Parametern address är null.
Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.
-eller-
Ett fel uppstod när strömmen öppnades.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Metoden OpenWrite returnerar en skrivbar ström som används för att skicka data till en resurs. Den här metoden blockerar när strömmen öppnas. Om du vill fortsätta köra i väntan på dataströmmen använder du någon av OpenWriteAsync metoderna.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.