Sdílet prostřednictvím

WebClient.OpenWrite Metoda

  • Reference

Definice

Obor názvů:
System.Net
Sestavení:
System.Net.WebClient.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll

Otevře datový proud pro zápis dat do prostředku se zadaným identifikátorem URI.

Přetížení

OpenWrite(String)

Otevře datový proud pro zápis dat do zadaného prostředku.
OpenWrite(Uri)

Otevře datový proud pro zápis dat do zadaného prostředku.
OpenWrite(String, String)

Otevře datový proud pro zápis dat do zadaného prostředku pomocí zadané metody.
OpenWrite(Uri, String)

Otevře datový proud pro zápis dat do zadaného prostředku pomocí zadané metody.

OpenWrite(String)

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku.

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

Parametry

address
String

Identifikátor URI prostředku pro příjem dat.

Návraty

Stream

Stream sloužící k zápisu dat do prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddressa address je neplatný.

-nebo-

Při otevírání datového proudu došlo k chybě.

Příklady

Následující příklad kódu čte data z příkazového řádku a používá OpenWrite k získání datového proudu pro zápis dat. Stream vrácená OpenWrite se po odeslání dat zavře.

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

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda OpenWrite vrátí zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Tato metoda blokuje při otevírání datového proudu. Pokud chcete pokračovat v provádění při čekání na datový proud, použijte jednu z metod OpenWriteAsync.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se použije metoda POST.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

Platí pro

OpenWrite(Uri)

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku.

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

Parametry

address
Uri

Identifikátor URI prostředku pro příjem dat.

Návraty

Stream

Stream sloužící k zápisu dat do prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddressa address je neplatný.

-nebo-

Při otevírání datového proudu došlo k chybě.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda OpenWrite vrátí zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Tato metoda blokuje při otevírání datového proudu. Pokud chcete pokračovat v provádění při čekání na datový proud, použijte jednu z metod OpenWriteAsync.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se použije metoda POST.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

Platí pro

OpenWrite(String, String)

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku pomocí zadané metody.

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

Parametry

address
String

Identifikátor URI prostředku pro příjem dat.

method
String

Metoda použitá k odeslání dat do prostředku. Pokud má hodnotu null, výchozí hodnota je POST pro http a STOR pro ftp.

Návraty

Stream

Stream sloužící k zápisu dat do prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddressa address je neplatný.

-nebo-

Při otevírání datového proudu došlo k chybě.

Příklady

Následující příklad kódu čte data z příkazového řádku a používá OpenWrite k získání datového proudu použitého k zápisu dat. Stream vrácená OpenWrite musí být uzavřena, aby bylo možné data odeslat.

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

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda OpenWrite vrátí zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Podkladový požadavek se provede metodou zadanou v parametru method. Data se po zavření datového proudu odesílají na server. Tato metoda blokuje při otevírání datového proudu. Pokud chcete pokračovat v provádění při čekání na datový proud, použijte jednu z metod OpenWriteAsync.

Pokud parametr method určuje metodu, která není serverem srozumitelná, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

Pokud vlastnost BaseAddress není prázdný řetězec ("") a address nezadá absolutní adresu, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

Platí pro

OpenWrite(Uri, String)

Zdroj:
WebClient.cs
Zdroj:
WebClient.cs
Zdroj:
WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku pomocí zadané metody.

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

Parametry

address
Uri

Identifikátor URI prostředku pro příjem dat.

method
String

Metoda použitá k odeslání dat do prostředku. Pokud má hodnotu null, výchozí hodnota je POST pro http a STOR pro ftp.

Návraty

Stream

Stream sloužící k zápisu dat do prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddressa address je neplatný.

-nebo-

Při otevírání datového proudu došlo k chybě.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda OpenWrite vrátí zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Tato metoda blokuje při otevírání datového proudu. Pokud chcete pokračovat v provádění při čekání na datový proud, použijte jednu z metod OpenWriteAsync.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

Platí pro