WebClient.UploadData Metod

Definition

Namnområde:
System.Net
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Laddar upp en databuffert till en resurs med angiven URI.

Överlagringar

Name Description
UploadData(String, Byte[])

Laddar upp en databuffert till en resurs som identifieras av en URI.
UploadData(Uri, Byte[])

Laddar upp en databuffert till en resurs som identifieras av en URI.
UploadData(String, String, Byte[])

Laddar upp en databuffert till den angivna resursen med den angivna metoden.
UploadData(Uri, String, Byte[])

Laddar upp en databuffert till den angivna resursen med den angivna metoden.

UploadData(String, Byte[])

Laddar upp en databuffert till en resurs som identifieras av en URI.

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, cli::array <System::Byte> ^ data);
public byte[] UploadData(string address, byte[] data);
member this.UploadData : string * byte[] -> byte[]
Public Function UploadData (address As String, data As Byte()) As Byte()

Parametrar

address
String

Resursens URI för att ta emot data.

data
Byte[]

Databufferten som ska skickas till resursen.

Returer

Byte[]

En Byte matris som innehåller svarets brödtext från resursen.

Undantag

ArgumentNullException

Parametern address är null.

WebException

Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.

-eller-

data är null.

-eller-

Ett fel uppstod när data skulle skickas.

-eller-

Det fanns inget svar från servern som var värd för resursen.

Exempel

I följande kodexempel konverteras en sträng som angetts från konsolen till en Byte matris och matrisen skickas till den angivna servern med hjälp av UploadData. Alla svar från servern visas i konsolen.

Console::Write( "\nPlease enter the URI to post data to: " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII Encoding to obtain the String* as a Byte array.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

//UploadData implicitly sets HTTP POST as the request method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, postArray );

// Decode and display the response.
Console::WriteLine( "\nResponse received was: {0}", Encoding::ASCII->GetString( responseArray ) );

    Console.Write("\nPlease enter the URI to post data to : ");
    string uriString = Console.ReadLine();
    // Create a new WebClient instance.
    WebClient myWebClient = new WebClient();
    Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
    string postData = Console.ReadLine();
    // Apply ASCII Encoding to obtain the string as a byte array.
    byte[] postArray = Encoding.ASCII.GetBytes(postData);
    Console.WriteLine("Uploading to {0} ...",  uriString);							
 myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

    //UploadData implicitly sets HTTP POST as the request method.
    byte[] responseArray = myWebClient.UploadData(uriString,postArray);

    // Decode and display the response.
    Console.WriteLine("\nResponse received was :{0}", Encoding.ASCII.GetString(responseArray));

Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
Dim uriString As String = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
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 the string as a byte array.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' UploadData implicitly sets HTTP POST as the request method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, postArray)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))

Kommentarer

Caution

WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.

Metoden UploadData skickar en databuffert till en resurs.

Den här metoden använder STOR-kommandot för att ladda upp en FTP-resurs. För en HTTP-resurs används POST-metoden. Om den underliggande begäran inte förstås av servern avgör de underliggande protokollklasserna vad som händer. Vanligtvis genereras en WebException med egenskapen Status inställd för att indikera felet.

Metoden UploadData skickar innehållet data i till servern utan att koda det. Den här metoden blockerar när data laddas upp. Om du vill fortsätta köra i väntan på serverns svar använder du någon av UploadDataAsync metoderna.

Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.

Gäller för

UploadData(Uri, Byte[])

Laddar upp en databuffert till en resurs som identifieras av en URI.

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, cli::array <System::Byte> ^ data);
public byte[] UploadData(Uri address, byte[] data);
member this.UploadData : Uri * byte[] -> byte[]
Public Function UploadData (address As Uri, data As Byte()) As Byte()

Parametrar

address
Uri

Resursens URI för att ta emot data.

data
Byte[]

Databufferten som ska skickas till resursen.

Returer

Byte[]

En Byte matris som innehåller svarets brödtext från resursen.

Undantag

ArgumentNullException

Parametern address är null.

WebException

Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.

-eller-

data är null.

-eller-

Ett fel uppstod när data skulle skickas.

-eller-

Det fanns inget svar från servern som var värd för resursen.

Kommentarer

Caution

WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.

Metoden UploadData skickar en databuffert till en resurs.

Den här metoden använder STOR-kommandot för att ladda upp en FTP-resurs. För en HTTP-resurs används POST-metoden. Om den underliggande begäran inte förstås av servern avgör de underliggande protokollklasserna vad som händer. Vanligtvis genereras en WebException med egenskapen Status inställd för att indikera felet.

Metoden UploadData skickar innehållet data i till servern utan att koda det. Den här metoden blockerar när data laddas upp. Om du vill fortsätta köra i väntan på serverns svar använder du någon av UploadDataAsync metoderna.

Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.

Gäller för

UploadData(String, String, Byte[])

Laddar upp en databuffert till den angivna resursen med den angivna metoden.

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public byte[] UploadData(string address, string method, byte[] data);
member this.UploadData : string * string * byte[] -> byte[]
Public Function UploadData (address As String, method As String, data As Byte()) As Byte()

Parametrar

address
String

Resursens URI för att ta emot data.

method
String

HTTP-metoden som används för att skicka data till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.

data
Byte[]

Databufferten som ska skickas till resursen.

Returer

Byte[]

En Byte matris som innehåller svarets brödtext från resursen.

Undantag

ArgumentNullException

Parametern address är null.

WebException

Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.

-eller-

data är null.

-eller-

Ett fel uppstod när data skulle laddas upp.

-eller-

Det fanns inget svar från servern som var värd för resursen.

Exempel

I följande kodexempel konverteras en sträng som angetts från konsolen till en bytematris och skickar matrisen till den angivna servern med hjälp av UploadData. Alla svar från servern visas i konsolen.

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to {for example, http://www.contoso.com}: " );
uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

// Displays the headers in the request
Console::Write( "Resulting Request Headers: ");
Console::WriteLine(myWebClient->Headers);

// Apply ASCII Encoding to obtain the String^ as a Byte array.
array<Byte>^ byteArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
// Upload the input String* using the HTTP 1.0 POST method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, "POST", byteArray );
// Decode and display the response.
Console::WriteLine( "\nResponse received was {0}",
   Encoding::ASCII->GetString( responseArray ) );

   string uriString;
       Console.Write("\nPlease enter the URI to post data to {for example, http://www.contoso.com} : ");
       uriString = Console.ReadLine();

       // Create a new WebClient instance.
       WebClient myWebClient = new WebClient();
       Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
       string postData = Console.ReadLine();
       myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

 // Display the headers in the request
       Console.Write("Resulting Request Headers: ");
       Console.WriteLine(myWebClient.Headers.ToString());
       
       // Apply ASCII Encoding to obtain the string as a byte array.

       byte[] byteArray = Encoding.ASCII.GetBytes(postData);
       Console.WriteLine("Uploading to {0} ...",  uriString);						
       // Upload the input string using the HTTP 1.0 POST method.
       byte[] responseArray = myWebClient.UploadData(uriString,"POST",byteArray);
       
       // Decode and display the response.
       Console.WriteLine("\nResponse received was {0}",
       Encoding.ASCII.GetString(responseArray));
                 

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to{for example, http://www.contoso.com} : ")
uriString = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' Display the headers in the request
Console.Write("Resulting Request Headers: ")
Console.Writeline(myWebClient.Headers.ToString())

' Apply ASCII Encoding to obtain the string as a byte array.
Dim byteArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
' Upload the input string using the HTTP 1.0 POST method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, "POST", byteArray)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))

Kommentarer

Caution

WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.

Metoden UploadData skickar en databuffert till en resurs med hjälp av DEN HTTP-metod som anges i parametern method och returnerar alla svar från servern. Den här metoden blockerar när data laddas upp. Om du vill fortsätta köra i väntan på serverns svar använder du någon av UploadDataAsync metoderna.

Metoden UploadData skickar innehållet data i till servern utan att koda det.

Om parametern method anger ett verb som inte förstås av servern avgör de underliggande protokollklasserna vad som händer. Vanligtvis genereras en WebException med egenskapen Status inställd för att indikera felet.

Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.

Gäller för

UploadData(Uri, String, Byte[])

Laddar upp en databuffert till den angivna resursen med den angivna metoden.

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public byte[] UploadData(Uri address, string method, byte[] data);
member this.UploadData : Uri * string * byte[] -> byte[]
Public Function UploadData (address As Uri, method As String, data As Byte()) As Byte()

Parametrar

address
Uri

Resursens URI för att ta emot data.

method
String

HTTP-metoden som används för att skicka data till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.

data
Byte[]

Databufferten som ska skickas till resursen.

Returer

Byte[]

En Byte matris som innehåller svarets brödtext från resursen.

Undantag

ArgumentNullException

Parametern address är null.

WebException

Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.

-eller-

data är null.

-eller-

Ett fel uppstod när data skulle laddas upp.

-eller-

Det fanns inget svar från servern som var värd för resursen.

Kommentarer

Caution

WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.

Metoden UploadData skickar en databuffert till en resurs med hjälp av DEN HTTP-metod som anges i parametern method och returnerar alla svar från servern. Den här metoden blockerar när data laddas upp. Om du vill fortsätta köra i väntan på serverns svar använder du någon av UploadDataAsync metoderna.

Metoden UploadData skickar innehållet data i till servern utan att koda det.

Om parametern method anger ett verb som inte förstås av servern avgör de underliggande protokollklasserna vad som händer. Vanligtvis genereras en WebException med egenskapen Status inställd för att indikera felet.

Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.

Gäller för