WebClient.OpenWrite WebClient.OpenWrite WebClient.OpenWrite WebClient.OpenWrite Method

Definition

Öffnet einen Stream, um Daten in eine Ressource mit dem angegebenen URI zu schreiben.Opens a stream for writing data to a resource with the specified URI.

Überlädt

OpenWrite(String) OpenWrite(String) OpenWrite(String) OpenWrite(String)

Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben.Opens a stream for writing data to the specified resource.

OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri)

Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben.Opens a stream for writing data to the specified resource.

OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String)

Öffnet mithilfe der angegebenen Methode einen Stream zum Schreiben von Daten in die angegebene Ressource.Opens a stream for writing data to the specified resource, using the specified method.

OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String)

Öffnet mithilfe der angegebenen Methode einen Stream zum Schreiben von Daten in die angegebene Ressource.Opens a stream for writing data to the specified resource, by using the specified method.

OpenWrite(String) OpenWrite(String) OpenWrite(String) OpenWrite(String)

Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben.Opens a stream for writing data to the specified resource.

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

Parameter

address
String String String String

Der URI der Ressource, die die Daten empfangen soll.The URI of the resource to receive the data.

Gibt zurück

Ein Stream, der zum Schreiben von Daten in eine Ressource verwendet wird.A Stream used to write data to the resource.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress, and address is invalid.

- oder --or- Fehler beim Öffnen des Streams.An error occurred while opening the stream.

Beispiele

Im folgenden Codebeispiel werden Daten aus der Befehlszeile gelesen, und es wird OpenWrite verwendet, um einen Stream zum Schreiben der Daten abzurufen.The following code example reads data from the command line and uses OpenWrite to obtain a stream for writing the data. Beachten Sie, dass die von OpenWrite zurückgegebene Stream nach dem Senden der Daten geschlossen wird.Note that the Stream returned by OpenWrite is closed after the data is sent.

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.")

Hinweise

Die OpenWrite-Methode gibt einen beschreibbaren Datenstrom zurück, der zum Senden von Daten an eine Ressource verwendet wird.The OpenWrite method returns a writable stream that is used to send data to a resource. Diese Methode wird beim Öffnen des Streams blockiert.This method blocks while opening the stream. Wenn Sie die Ausführung beim Warten auf den Stream fortsetzen möchten, verwenden Sie eine der OpenWriteAsync-Methoden.To continue executing while waiting for the stream, use one of the OpenWriteAsync methods.

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString-Eigenschaft keine leere Zeichenfolge ist, wird Sie an address angefügt.If the QueryString property is not an empty string, it is appended to address.

Diese Methode verwendet den Befehl "Stor" zum Hochladen einer FTP-Ressource.This method uses the STOR command to upload an FTP resource. Bei einer HTTP-Ressource wird die Post-Methode verwendet.For an HTTP resource, the POST method is used.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri)

Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben.Opens a stream for writing data to the specified resource.

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

Parameter

address
Uri Uri Uri Uri

Der URI der Ressource, die die Daten empfangen soll.The URI of the resource to receive the data.

Gibt zurück

Ein Stream, der zum Schreiben von Daten in eine Ressource verwendet wird.A Stream used to write data to the resource.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress, and address is invalid.

- oder --or- Fehler beim Öffnen des Streams.An error occurred while opening the stream.

Hinweise

Die OpenWrite-Methode gibt einen beschreibbaren Datenstrom zurück, der zum Senden von Daten an eine Ressource verwendet wird.The OpenWrite method returns a writable stream that is used to send data to a resource. Diese Methode wird beim Öffnen des Streams blockiert.This method blocks while opening the stream. Wenn Sie die Ausführung beim Warten auf den Stream fortsetzen möchten, verwenden Sie eine der OpenWriteAsync-Methoden.To continue executing while waiting for the stream, use one of the OpenWriteAsync methods.

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString-Eigenschaft keine leere Zeichenfolge ist, wird Sie an address angefügt.If the QueryString property is not an empty string, it is appended to address.

Diese Methode verwendet den Befehl "Stor" zum Hochladen einer FTP-Ressource.This method uses the STOR command to upload an FTP resource. Bei einer HTTP-Ressource wird die Post-Methode verwendet.For an HTTP resource, the POST method is used.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String)

Öffnet mithilfe der angegebenen Methode einen Stream zum Schreiben von Daten in die angegebene Ressource.Opens a stream for writing data to the specified resource, using the specified method.

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

Parameter

address
String String String String

Der URI der Ressource, die die Daten empfangen soll.The URI of the resource to receive the data.

method
String String String String

Die Methode, die zum Senden der Daten an die Ressource verwendet wird.The method used to send the data to the resource. Wenn NULL, lautet der Standard für http POST und für ftp STOR.If null, the default is POST for http and STOR for ftp.

Gibt zurück

Ein Stream, der zum Schreiben von Daten in eine Ressource verwendet wird.A Stream used to write data to the resource.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress, and address is invalid.

- oder --or- Fehler beim Öffnen des Streams.An error occurred while opening the stream.

Beispiele

Im folgenden Codebeispiel werden Daten aus der Befehlszeile gelesen, und es wird OpenWrite zum Abrufen eines Datenstroms verwendet, der zum Schreiben der Daten verwendet wird.The following code example reads data from the command line and uses OpenWrite to obtain a stream used to write the data. Beachten Sie, dass die von OpenWrite zurückgegebene Stream geschlossen werden muss, damit die Daten gesendet werden.Note that the Stream returned by OpenWrite must be closed to send 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 .
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.")

Hinweise

Die OpenWrite-Methode gibt einen beschreibbaren Datenstrom zurück, der zum Senden von Daten an eine Ressource verwendet wird.The OpenWrite method returns a writable stream that is used to send data to a resource. Die zugrunde liegende Anforderung wird mit der im method-Parameter angegebenen Methode erstellt.The underlying request is made with the method specified in the method parameter. Die Daten werden an den Server gesendet, wenn Sie den Stream schließen.The data is sent to the server when you close the stream. Diese Methode wird beim Öffnen des Streams blockiert.This method blocks while opening the stream. Wenn Sie die Ausführung beim Warten auf den Stream fortsetzen möchten, verwenden Sie eine der OpenWriteAsync-Methoden.To continue executing while waiting for the stream, use one of the OpenWriteAsync methods.

Wenn der method-Parameter eine Methode angibt, die vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokoll Klassen, was passiert.If the method parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. In der Regel wird eine WebException ausgelöst, wenn die Status-Eigenschaft festgelegt ist, um den Fehler anzugeben.Typically, a WebException is thrown with the Status property set to indicate the error.

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keine absolute Adresse angibt, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not specify an absolute address, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString-Eigenschaft keine leere Zeichenfolge ist, wird Sie an address angefügt.If the QueryString property is not an empty string, it is appended to address.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String)

Öffnet mithilfe der angegebenen Methode einen Stream zum Schreiben von Daten in die angegebene Ressource.Opens a stream for writing data to the specified resource, by using the specified method.

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

Parameter

address
Uri Uri Uri Uri

Der URI der Ressource, die die Daten empfangen soll.The URI of the resource to receive the data.

method
String String String String

Die Methode, die zum Senden der Daten an die Ressource verwendet wird.The method used to send the data to the resource. Wenn NULL, lautet der Standard für http POST und für ftp STOR.If null, the default is POST for http and STOR for ftp.

Gibt zurück

Ein Stream, der zum Schreiben von Daten in eine Ressource verwendet wird.A Stream used to write data to the resource.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress, and address is invalid.

- oder --or- Fehler beim Öffnen des Streams.An error occurred while opening the stream.

Hinweise

Die OpenWrite-Methode gibt einen beschreibbaren Datenstrom zurück, der zum Senden von Daten an eine Ressource verwendet wird.The OpenWrite method returns a writable stream that is used to send data to a resource. Diese Methode wird beim Öffnen des Streams blockiert.This method blocks while opening the stream. Wenn Sie die Ausführung beim Warten auf den Stream fortsetzen möchten, verwenden Sie eine der OpenWriteAsync-Methoden.To continue executing while waiting for the stream, use one of the OpenWriteAsync methods.

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString-Eigenschaft keine leere Zeichenfolge ist, wird Sie an address angefügt.If the QueryString property is not an empty string, it is appended to address.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

Gilt für: