WebClient.OpenWrite 方法

參考

定義

命名空間:: System.Net

組件:: System.Net.WebClient.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

開啟資料流，以使用指定的 URI 將數據寫入資源。

多載

OpenWrite(String)	開啟數據流以將數據寫入指定的資源。
OpenWrite(Uri)	開啟數據流以將數據寫入指定的資源。
OpenWrite(String, String)	使用指定的方法，開啟數據流以將數據寫入指定的資源。
OpenWrite(Uri, String)	使用指定的方法，開啟數據流以將數據寫入指定的資源。

OpenWrite(String)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: WebClient.cs

開啟數據流以將數據寫入指定的資源。

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

參數

address: String

要接收數據之資源的 URI。

傳回

Stream

用來將數據寫入資源的 Stream。

例外狀況

ArgumentNullException

address 參數是 null。

WebException

結合 BaseAddress和 address 所形成的 URI 無效。

-或-

開啟數據流時發生錯誤。

範例

下列程式代碼範例會從命令行讀取數據，並使用 OpenWrite 取得數據流來寫入數據。傳送數據之後，OpenWrite 所傳回的 Stream 會關閉。

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

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。請改用 HttpClient。

OpenWrite 方法會傳回可寫入的數據流，用來將數據傳送至資源。這個方法會在開啟數據流時封鎖。若要在等候數據流時繼續執行，請使用其中一個 OpenWriteAsync 方法。

如果 BaseAddress 屬性不是空字串（“”）且 address 不包含絕對 URI，address 必須是與 BaseAddress 結合的相對 URI，才能形成所要求數據的絕對 URI。如果 QueryString 屬性不是空字串，則會附加至 address。

此方法會使用 STOR 命令來上傳 FTP 資源。如果是 HTTP 資源，則會使用 POST 方法。

注意

當您在應用程式中啟用網路追蹤時，此成員會輸出追蹤資訊。如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

適用於

OpenWrite(Uri)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: WebClient.cs

開啟數據流以將數據寫入指定的資源。

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

參數

address: Uri

要接收數據之資源的 URI。

傳回

Stream

用來將數據寫入資源的 Stream。

例外狀況

ArgumentNullException

address 參數是 null。

WebException

結合 BaseAddress和 address 所形成的 URI 無效。

-或-

開啟數據流時發生錯誤。

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。請改用 HttpClient。

此方法會使用 STOR 命令來上傳 FTP 資源。如果是 HTTP 資源，則會使用 POST 方法。

注意

當您在應用程式中啟用網路追蹤時，此成員會輸出追蹤資訊。如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

適用於

OpenWrite(String, String)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: WebClient.cs

使用指定的方法，開啟數據流以將數據寫入指定的資源。

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

參數

address: String

要接收數據之資源的 URI。

method: String

用來將數據傳送至資源的方法。如果為 null，則預設值為 HTTP 的 POST，而 FTP 則為 STOR。

傳回

Stream

用來將數據寫入資源的 Stream。

例外狀況

ArgumentNullException

address 參數是 null。

WebException

結合 BaseAddress和 address 所形成的 URI 無效。

-或-

開啟數據流時發生錯誤。

範例

下列程式代碼範例會從命令行讀取數據，並使用 OpenWrite 取得用來寫入數據的數據流。 OpenWrite 傳回的 Stream 必須關閉，才能傳送數據。

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

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。請改用 HttpClient。

OpenWrite 方法會傳回可寫入的數據流，用來將數據傳送至資源。基礎要求是以 method 參數中指定的方法進行。當您關閉數據流時，數據會傳送至伺服器。這個方法會在開啟數據流時封鎖。若要在等候數據流時繼續執行，請使用其中一個 OpenWriteAsync 方法。

如果 method 參數指定伺服器無法理解的方法，基礎通訊協定類別會決定會發生什麼事。一般而言，會擲回 WebException，並將 Status 屬性設定為表示錯誤。

如果 BaseAddress 屬性不是空字串（“”），且 address 未指定絕對位址，address 必須是與 BaseAddress 結合的相對 URI，才能形成所要求數據的絕對 URI。如果 QueryString 屬性不是空字串，則會附加至 address。

注意

當您在應用程式中啟用網路追蹤時，此成員會輸出追蹤資訊。如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

適用於

OpenWrite(Uri, String)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: WebClient.cs

使用指定的方法，開啟數據流以將數據寫入指定的資源。

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

參數

address: Uri

要接收數據之資源的 URI。

method: String

用來將數據傳送至資源的方法。如果為 null，則預設值為 HTTP 的 POST，而 FTP 則為 STOR。

傳回

Stream

用來將數據寫入資源的 Stream。

例外狀況

ArgumentNullException

address 參數是 null。

WebException

結合 BaseAddress和 address 所形成的 URI 無效。

-或-

開啟數據流時發生錯誤。

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。請改用 HttpClient。

注意

當您在應用程式中啟用網路追蹤時，此成員會輸出追蹤資訊。如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

適用於

共用方式為

WebClient.OpenWrite 方法

定義

多載

OpenWrite(String)

參數

傳回

例外狀況

範例

備註

適用於

OpenWrite(Uri)

參數

傳回

例外狀況

備註

適用於

OpenWrite(String, String)

參數

傳回

例外狀況

範例

備註

適用於

OpenWrite(Uri, String)

參數

傳回

例外狀況

備註

適用於

意見反應

其他資源