WebClient.OpenWrite Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Otwiera strumień do zapisywania danych w zasobie przy użyciu określonego identyfikatora URI.

Przeciążenia

OpenWrite(String)	Otwiera strumień do zapisywania danych w określonym zasobie.
OpenWrite(Uri)	Otwiera strumień do zapisywania danych w określonym zasobie.
OpenWrite(String, String)	Otwiera strumień do zapisywania danych do określonego zasobu przy użyciu określonej metody.
OpenWrite(Uri, String)	Otwiera strumień do zapisywania danych w określonym zasobie przy użyciu określonej metody.

OpenWrite(String)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych w określonym zasobie.

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

Identyfikator URI zasobu do odbierania danych.

Zwraca

Stream

Element Stream używany do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

Identyfikator URI utworzony przez połączenie elementu BaseAddressi address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas otwierania strumienia.

Przykłady

Poniższy przykład kodu odczytuje dane z wiersza polecenia i używa OpenWrite go do uzyskania strumienia do zapisywania danych. Zwrócony Stream przez OpenWrite element jest zamykany po wysłaniu danych.

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

Uwagi

Metoda OpenWrite zwraca zapisywalny strumień, który jest używany do wysyłania danych do zasobu. Ta metoda blokuje podczas otwierania strumienia. Aby kontynuować wykonywanie podczas oczekiwania na strumień, użyj jednej z OpenWriteAsync metod.

BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do addresselementu .

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

OpenWrite(Uri)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych w określonym zasobie.

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

Identyfikator URI zasobu do odbierania danych.

Zwraca

Stream

Element Stream używany do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

Identyfikator URI utworzony przez połączenie elementu BaseAddressi address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas otwierania strumienia.

Uwagi

Metoda OpenWrite zwraca zapisywalny strumień, który jest używany do wysyłania danych do zasobu. Ta metoda blokuje podczas otwierania strumienia. Aby kontynuować wykonywanie podczas oczekiwania na strumień, użyj jednej z OpenWriteAsync metod.

BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do addresselementu .

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

OpenWrite(String, String)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych do określonego zasobu przy użyciu określonej metody.

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

Parametry

address

String

Identyfikator URI zasobu do odbierania danych.

method

String

Metoda używana do wysyłania danych do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i STOR dla protokołu FTP.

Zwraca

Stream

Element Stream używany do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

Identyfikator URI utworzony przez połączenie elementu BaseAddressi address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas otwierania strumienia.

Przykłady

Poniższy przykład kodu odczytuje dane z wiersza polecenia i używa OpenWrite go do uzyskania strumienia używanego do zapisywania danych. Zwrócony Stream przez OpenWrite program musi być zamknięty, aby wysłać dane.

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

Uwagi

Metoda OpenWrite zwraca zapisywalny strumień, który jest używany do wysyłania danych do zasobu. Żądanie podstawowe jest wykonywane przy użyciu metody określonej w parametrze method . Dane są wysyłane do serwera po zamknięciu strumienia. Ta metoda blokuje podczas otwierania strumienia. Aby kontynuować wykonywanie podczas oczekiwania na strumień, użyj jednej z OpenWriteAsync metod.

method Jeśli parametr określa metodę, która nie jest rozumiana przez serwer, podstawowe klasy protokołów określają, co się dzieje. WebException Zazwyczaj obiekt jest zgłaszany z właściwością ustawioną w Status celu wskazania błędu.

BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address nie określa adresu bezwzględnego, musi być względnym identyfikatorem URI połączonym address z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do addresselementu .

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

OpenWrite(Uri, String)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych w określonym zasobie przy użyciu określonej metody.

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

Parametry

address

Uri

Identyfikator URI zasobu do odbierania danych.

method

String

Metoda używana do wysyłania danych do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i STOR dla protokołu FTP.

Zwraca

Stream

Element Stream używany do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

Identyfikator URI utworzony przez połączenie elementu BaseAddressi address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas otwierania strumienia.

Uwagi

Metoda OpenWrite zwraca zapisywalny strumień, który jest używany do wysyłania danych do zasobu. Ta metoda blokuje podczas otwierania strumienia. Aby kontynuować wykonywanie podczas oczekiwania na strumień, użyj jednej z OpenWriteAsync metod.

BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do addresselementu .

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.