Teilen über

WebClient.OpenWrite Methode

  • Referenz

Definition

Namespace:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Öffnet einen Datenstrom zum Schreiben von Daten in eine Ressource mit dem angegebenen URI.

Überlädt

OpenWrite(String)

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource.
OpenWrite(Uri)

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource.
OpenWrite(String, String)

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource mithilfe der angegebenen Methode.
OpenWrite(Uri, String)

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource mithilfe der angegebenen Methode.

OpenWrite(String)

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource.

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

Der URI der Ressource, die die Daten empfängt.

Gibt zurück

Stream

Ein Stream verwendet, um Daten in die Ressource zu schreiben.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

WebException

Der URI, der durch die Kombination von BaseAddressund address gebildet wird, ist ungültig.

-oder-

Fehler beim Öffnen des Datenstroms.

Beispiele

Im folgenden Codebeispiel werden Daten aus der Befehlszeile gelesen und OpenWrite verwendet, um einen Datenstrom zum Schreiben der Daten abzurufen. Die von OpenWrite zurückgegebene Stream wird geschlossen, nachdem die Daten gesendet wurden.

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

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die OpenWrite-Methode gibt einen schreibbaren Datenstrom zurück, der zum Senden von Daten an eine Ressource verwendet wird. Diese Methode blockiert beim Öffnen des Datenstroms. Wenn Sie weiterhin auf den Datenstrom warten möchten, verwenden Sie eine der OpenWriteAsync Methoden.

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. Wenn die eigenschaft QueryString keine leere Zeichenfolge ist, wird sie an addressangefügt.

Diese Methode verwendet den STOR-Befehl, um eine FTP-Ressource hochzuladen. Für eine HTTP-Ressource wird die POST-Methode verwendet.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Gilt für:

OpenWrite(Uri)

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource.

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

Der URI der Ressource, die die Daten empfängt.

Gibt zurück

Stream

Ein Stream verwendet, um Daten in die Ressource zu schreiben.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

WebException

Der URI, der durch die Kombination von BaseAddressund address gebildet wird, ist ungültig.

-oder-

Fehler beim Öffnen des Datenstroms.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die OpenWrite-Methode gibt einen schreibbaren Datenstrom zurück, der zum Senden von Daten an eine Ressource verwendet wird. Diese Methode blockiert beim Öffnen des Datenstroms. Wenn Sie weiterhin auf den Datenstrom warten möchten, verwenden Sie eine der OpenWriteAsync Methoden.

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. Wenn die eigenschaft QueryString keine leere Zeichenfolge ist, wird sie an addressangefügt.

Diese Methode verwendet den STOR-Befehl, um eine FTP-Ressource hochzuladen. Für eine HTTP-Ressource wird die POST-Methode verwendet.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Gilt für:

OpenWrite(String, String)

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource mithilfe der angegebenen Methode.

public:
 System::IO::Stream ^ OpenWrite(System::String ^ address, System::String ^ method);
public System.IO.Stream OpenWrite (string address, 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

Der URI der Ressource, die die Daten empfängt.

method
String

Die Methode, die zum Senden der Daten an die Ressource verwendet wird. Wenn NULL, ist der Standardwert POST für HTTP und STOR für ftp.

Gibt zurück

Stream

Ein Stream verwendet, um Daten in die Ressource zu schreiben.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

WebException

Der URI, der durch die Kombination von BaseAddressund address gebildet wird, ist ungültig.

-oder-

Fehler beim Öffnen des Datenstroms.

Beispiele

Im folgenden Codebeispiel werden Daten aus der Befehlszeile gelesen und OpenWrite verwendet, um einen Datenstrom abzurufen, der zum Schreiben der Daten verwendet wird. Die von OpenWrite zurückgegebenen Stream müssen geschlossen werden, um die Daten zu senden.

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

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die OpenWrite-Methode gibt einen schreibbaren Datenstrom zurück, der zum Senden von Daten an eine Ressource verwendet wird. Die zugrunde liegende Anforderung wird mit der im method Parameter angegebenen Methode ausgeführt. Die Daten werden beim Schließen des Datenstroms an den Server gesendet. Diese Methode blockiert beim Öffnen des Datenstroms. Wenn Sie weiterhin auf den Datenstrom warten möchten, verwenden Sie eine der OpenWriteAsync Methoden.

Wenn der parameter method eine Methode angibt, die vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was auftritt. In der Regel wird ein WebException ausgelöst, wobei die Status-Eigenschaft festgelegt ist, um den Fehler anzugeben.

Wenn die eigenschaft BaseAddress keine leere Zeichenfolge ("") ist und address keine absolute Adresse angeben, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString keine leere Zeichenfolge ist, wird sie an addressangefügt.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Gilt für:

OpenWrite(Uri, String)

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource mithilfe der angegebenen Methode.

public:
 System::IO::Stream ^ OpenWrite(Uri ^ address, System::String ^ method);
public System.IO.Stream OpenWrite (Uri address, 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

Der URI der Ressource, die die Daten empfängt.

method
String

Die Methode, die zum Senden der Daten an die Ressource verwendet wird. Wenn NULL, ist der Standardwert POST für HTTP und STOR für ftp.

Gibt zurück

Stream

Ein Stream verwendet, um Daten in die Ressource zu schreiben.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

WebException

Der URI, der durch die Kombination von BaseAddressund address gebildet wird, ist ungültig.

-oder-

Fehler beim Öffnen des Datenstroms.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die OpenWrite-Methode gibt einen schreibbaren Datenstrom zurück, der zum Senden von Daten an eine Ressource verwendet wird. Diese Methode blockiert beim Öffnen des Datenstroms. Wenn Sie weiterhin auf den Datenstrom warten möchten, verwenden Sie eine der OpenWriteAsync Methoden.

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. Wenn die eigenschaft QueryString keine leere Zeichenfolge ist, wird sie an addressangefügt.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Gilt für: