WebClient.OpenWrite Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Otwiera strumień do zapisywania danych w zasobie z określonym identyfikatorem 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 w określonym zasobie 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

Służy Stream do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddresselementu i 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. Zwracany Stream przez element OpenWrite 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 pustym ciągiem, 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

Służy Stream do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddresselementu i 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 pustym ciągiem, 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 w określonym zasobie 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

Służy Stream do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddresselementu i 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. Zwracany Stream przez OpenWrite element musi zostać zamknięty w celu wysłania 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;

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 bazowe 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 zrozumiała dla serwera, podstawowe klasy protokołów określają, co się dzieje. WebException Zazwyczaj element jest zgłaszany z ustawioną właściwościąStatus, aby wskazać błąd.

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 pustym ciągiem, 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

Służy Stream do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddresselementu i 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 pustym ciągiem, 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.