WebClient.OpenWrite Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Megnyit egy adatfolyamot, amely adatokat ír egy erőforrásba a megadott URI-val.

Túlterhelések

Name	Description
OpenWrite(String)	Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba.
OpenWrite(Uri)	Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba.
OpenWrite(String, String)	Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba a megadott módszerrel.
OpenWrite(Uri, String)	Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba a megadott módszerrel.

OpenWrite(String)

Forrás:

WebClient.cs

Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba.

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

Paraméterek

address

String

Az erőforrás URI-ja az adatok fogadásához.

Válaszok

Stream

Az Stream erőforrásba való adatíráshoz használt.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Hiba történt a stream megnyitása közben.

Példák

Az alábbi példakód beolvassa az adatokat a parancssorból, és egy adatfolyam beszerzésére használja OpenWrite az adatok írásához. A Stream visszaadott OpenWrite adatok az adatok elküldése után bezárulnak.

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

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A OpenWrite metódus egy írható adatfolyamot ad vissza, amely adatokat küld egy erőforrásnak. Ez a metódus blokkolja a stream megnyitásakor. Ha folytatni szeretné a végrehajtást a streamre való várakozás közben, használja az egyik metódust OpenWriteAsync .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

OpenWrite(Uri)

Forrás:

WebClient.cs

Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba.

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

Paraméterek

address

Uri

Az erőforrás URI-ja az adatok fogadásához.

Válaszok

Stream

Az Stream erőforrásba való adatíráshoz használt.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Hiba történt a stream megnyitása közben.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A OpenWrite metódus egy írható adatfolyamot ad vissza, amely adatokat küld egy erőforrásnak. Ez a metódus blokkolja a stream megnyitásakor. Ha folytatni szeretné a végrehajtást a streamre való várakozás közben, használja az egyik metódust OpenWriteAsync .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

OpenWrite(String, String)

Forrás:

WebClient.cs

Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba a megadott módszerrel.

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

Paraméterek

address

String

Az erőforrás URI-ja az adatok fogadásához.

method

String

Az adatok erőforrásba való küldéséhez használt módszer. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.

Válaszok

Stream

Az Stream erőforrásba való adatíráshoz használt.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Hiba történt a stream megnyitása közben.

Példák

Az alábbi példakód beolvassa az adatokat a parancssorból, és az adatok írásához használt stream beszerzésére szolgál OpenWrite . A Stream visszaadott OpenWrite adatokat be kell zárni az adatok elküldéséhez.

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

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A OpenWrite metódus egy írható adatfolyamot ad vissza, amely adatokat küld egy erőforrásnak. A mögöttes kérés a paraméterben method megadott módszerrel történik. A rendszer a stream bezárásakor elküldi az adatokat a kiszolgálónak. Ez a metódus blokkolja a stream megnyitásakor. Ha folytatni szeretné a végrehajtást a streamre való várakozás közben, használja az egyik metódust OpenWriteAsync .

Ha a method paraméter olyan metódust ad meg, amelyet a kiszolgáló nem ért meg, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem ad meg abszolút címet, akkor relatív URI-nak kell lennie, address amely a kért adatok abszolút URI-jának létrehozásához van kombinálva BaseAddress . Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

OpenWrite(Uri, String)

Forrás:

WebClient.cs

Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba a megadott módszerrel.

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

Paraméterek

address

Uri

Az erőforrás URI-ja az adatok fogadásához.

method

String

Az adatok erőforrásba való küldéséhez használt módszer. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.

Válaszok

Stream

Az Stream erőforrásba való adatíráshoz használt.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Hiba történt a stream megnyitása közben.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A OpenWrite metódus egy írható adatfolyamot ad vissza, amely adatokat küld egy erőforrásnak. Ez a metódus blokkolja a stream megnyitásakor. Ha folytatni szeretné a végrehajtást a streamre való várakozás közben, használja az egyik metódust OpenWriteAsync .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.