WebClient.OpenWrite Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Slouží Stream k zápisu dat do prostředku.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddressaddress
a 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. Vrácená Stream službou 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
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 OpenWriteAsync metod .
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud 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žívá metoda POST.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete 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
Slouží Stream k zápisu dat do prostředku.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddressaddress
a je neplatný.
-nebo-
Při otevírání datového proudu došlo k chybě.
Poznámky
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 OpenWriteAsync metod .
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud 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žívá metoda POST.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete 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 null, výchozí hodnota je POST pro http a STOR pro ftp.
Návraty
Slouží Stream k zápisu dat do prostředku.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddressaddress
a 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. Aby Stream se data odeslala, OpenWrite musí být uzavřená.
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
Metoda OpenWrite vrátí zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Podkladový požadavek se vytvoří pomocí metody zadané v parametru method
. Data se po zavření datového proudu odešlou 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 OpenWriteAsync metod .
method
Pokud parametr určuje metodu, která není serveru srozumitelná, třídy podkladových protokolů určují, co se stane. Obvykle WebException je vyvolán s vlastností nastavenou Status k označení chyby.
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neurčuje absolutní adresu, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, připojí se k address
.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete 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 null, výchozí hodnota je POST pro http a STOR pro ftp.
Návraty
Slouží Stream k zápisu dat do prostředku.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddressaddress
a je neplatný.
-nebo-
Při otevírání datového proudu došlo k chybě.
Poznámky
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 OpenWriteAsync metod .
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, připojí se k address
.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro