WebClient.OpenWrite Methode

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

Parameters

Retouren

Een Stream gebruikt om gegevens naar de resource te schrijven.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld worden gegevens van de opdrachtregel gelezen en gebruikt OpenWrite om een stroom te verkrijgen voor het schrijven van de gegevens. De Stream geretourneerde waarde OpenWrite wordt gesloten nadat de gegevens zijn verzonden.

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

Opmerkingen

De OpenWrite methode retourneert een beschrijfbare stroom die wordt gebruikt om gegevens naar een resource te verzenden. Deze methode blokkeert tijdens het openen van de stream. Als u wilt doorgaan met het uitvoeren van de stream, gebruikt u een van de OpenWriteAsync methoden.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.

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

Parameters

Retouren

Een Stream gebruikt om gegevens naar de resource te schrijven.

Uitzonderingen

Opmerkingen

De OpenWrite methode retourneert een beschrijfbare stroom die wordt gebruikt om gegevens naar een resource te verzenden. Deze methode blokkeert tijdens het openen van de stream. Als u wilt doorgaan met het uitvoeren van de stream, gebruikt u een van de OpenWriteAsync methoden.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.

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

Parameters

Retouren

Een Stream gebruikt om gegevens naar de resource te schrijven.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld worden gegevens van de opdrachtregel gelezen en gebruikt OpenWrite om een stroom te verkrijgen die wordt gebruikt om de gegevens te schrijven. De Stream geretourneerde OpenWrite gegevens moeten worden gesloten om de gegevens te verzenden.

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

Opmerkingen

De OpenWrite methode retourneert een beschrijfbare stroom die wordt gebruikt om gegevens naar een resource te verzenden. De onderliggende aanvraag wordt gedaan met de methode die is opgegeven in de method parameter. De gegevens worden naar de server verzonden wanneer u de stream sluit. Deze methode blokkeert tijdens het openen van de stream. Als u wilt doorgaan met het uitvoeren van de stream, gebruikt u een van de OpenWriteAsync methoden.

Als de method parameter een methode opgeeft die niet door de server wordt begrepen, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absoluut adres opgeeft, address moet dit een relatieve URI zijn die wordt gecombineerd om BaseAddress de absolute URI van de aangevraagde gegevens te vormen. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

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

Parameters

Retouren

Een Stream gebruikt om gegevens naar de resource te schrijven.

Uitzonderingen

Opmerkingen

De OpenWrite methode retourneert een beschrijfbare stroom die wordt gebruikt om gegevens naar een resource te verzenden. Deze methode blokkeert tijdens het openen van de stream. Als u wilt doorgaan met het uitvoeren van de stream, gebruikt u een van de OpenWriteAsync methoden.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.