WebClient.UploadString WebClient.UploadString WebClient.UploadString WebClient.UploadString Method

Definizione

Carica la stringa specificata nella risorsa specificata.Uploads the specified string to the specified resource.

Overload

UploadString(String, String) UploadString(String, String) UploadString(String, String) UploadString(String, String)

Carica la stringa specificata sulla risorsa specificata utilizzando il metodo POST.Uploads the specified string to the specified resource, using the POST method.

UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String)

Carica la stringa specificata sulla risorsa specificata utilizzando il metodo POST.Uploads the specified string to the specified resource, using the POST method.

UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String)

Carica la stringa specificata sulla risorsa specificata utilizzando il metodo specificato.Uploads the specified string to the specified resource, using the specified method.

UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String)

Carica la stringa specificata sulla risorsa specificata utilizzando il metodo specificato.Uploads the specified string to the specified resource, using the specified method.

UploadString(String, String) UploadString(String, String) UploadString(String, String) UploadString(String, String)

Carica la stringa specificata sulla risorsa specificata utilizzando il metodo POST.Uploads the specified string to the specified resource, using the POST method.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ data);
public string UploadString (string address, string data);
member this.UploadString : string * string -> string
Public Function UploadString (address As String, data As String) As String

Parametri

address
String String String String

L'URI della risorsa per ricevere la stringa.The URI of the resource to receive the string. Per le risorse HTTP, questo URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.For Http resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

data
String String String String

Stringa da caricare.The string to be uploaded.

Restituisce

Classe String contenente la risposta inviata dal server.A String containing the response sent by the server.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro data è null.The data parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

Esempi

Esempio di codice seguente viene illustrato come chiamare questo metodo.The following code example demonstrates calling this method.

void UploadString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   WebClient^ client = gcnew WebClient;
   
   // Optionally specify an encoding for uploading and downloading strings.
   client->Encoding = System::Text::Encoding::UTF8;
   
   // Upload the data.
   String^ reply = client->UploadString( address, data );
   
   // Disply the server's response.
   Console::WriteLine( reply );
}


public static void UploadString (string address)
{
    string data = "Time = 12:00am temperature = 50";
    WebClient client = new WebClient ();
    // Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8;
    // Upload the data.
    string reply = client.UploadString (address, data);
    // Disply the server's response.
    Console.WriteLine (reply);
}

Public Shared Sub UploadString(ByVal address As String)

	Dim data As String = "Time = 12:00am temperature = 50"
	Dim client As WebClient = New WebClient()
	'  Optionally specify an encoding for uploading and downloading strings.
	client.Encoding = System.Text.Encoding.UTF8
	'  Upload the data.
	Dim reply As String = client.UploadString(address, data)
	'  Disply the server's response.
	Console.WriteLine(reply)
End Sub

Commenti

Prima di caricare la stringa, questo metodo lo converte in un Byte matrice usando la codifica specificata nella Encoding proprietà.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Questo metodo si blocca durante la trasmissione della stringa.This method blocks while the string is transmitted. Per inviare una stringa e continuare l'esecuzione durante l'attesa di risposta del server, usare uno del UploadStringAsync metodi.To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.

Se il BaseAddress proprietà non è una stringa vuota (""), e address non contiene un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string (""), and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Questo metodo Usa il comando STOR per caricare una risorsa di FTP.This method uses the STOR command to upload an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo POST.For an HTTP resource, the POST method is used.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String)

Carica la stringa specificata sulla risorsa specificata utilizzando il metodo POST.Uploads the specified string to the specified resource, using the POST method.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ data);
public string UploadString (Uri address, string data);
member this.UploadString : Uri * string -> string
Public Function UploadString (address As Uri, data As String) As String

Parametri

address
Uri Uri Uri Uri

L'URI della risorsa per ricevere la stringa.The URI of the resource to receive the string. Per le risorse HTTP, questo URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.For Http resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

data
String String String String

Stringa da caricare.The string to be uploaded.

Restituisce

Classe String contenente la risposta inviata dal server.A String containing the response sent by the server.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro data è null.The data parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

Commenti

Prima di caricare la stringa, questo metodo lo converte in un Byte matrice usando la codifica specificata nella Encoding proprietà.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Questo metodo si blocca durante la trasmissione della stringa.This method blocks while the string is transmitted. Per inviare una stringa e continuare l'esecuzione durante l'attesa di risposta del server, usare uno del UploadStringAsync metodi.To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.

Se il BaseAddress proprietà non è una stringa vuota (""), e address non contiene un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string (""), and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Questo metodo Usa il comando STOR per caricare una risorsa di FTP.This method uses the STOR command to upload an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo POST.For an HTTP resource, the POST method is used.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String)

Carica la stringa specificata sulla risorsa specificata utilizzando il metodo specificato.Uploads the specified string to the specified resource, using the specified method.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ method, System::String ^ data);
public string UploadString (string address, string method, string data);
member this.UploadString : string * string * string -> string
Public Function UploadString (address As String, method As String, data As String) As String

Parametri

address
String String String String

L'URI della risorsa per ricevere la stringa.The URI of the resource to receive the string. L'URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo method.This URI must identify a resource that can accept a request sent with the method method.

method
String String String String

Il metodo HTTP utilizzato per inviare la stringa alla risorsa.The HTTP method used to send the string to the resource. Se il valore è null, l'impostazione predefinita sarà POST per http e STOR per ftp.If null, the default is POST for http and STOR for ftp.

data
String String String String

Stringa da caricare.The string to be uploaded.

Restituisce

Classe String contenente la risposta inviata dal server.A String containing the response sent by the server.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro data è null.The data parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

In alternativa-or- Non è possibile utilizzare method per inviare contenuto.method cannot be used to send content.

Esempi

Esempio di codice seguente viene illustrato come chiamare questo metodo.The following code example demonstrates calling this method.

void PostString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   String^ method = "POST";
   WebClient^ client = gcnew WebClient;
   String^ reply = client->UploadString( address, method, data );
   Console::WriteLine( reply );
}


public static void PostString (string address)
{
    string data = "Time = 12:00am temperature = 50";
    string method = "POST";
    WebClient client = new WebClient ();
    string reply = client.UploadString (address, method, data);

    Console.WriteLine (reply);
}

Public Shared Sub PostString(ByVal address As String)

	Dim data As String = "Time = 12:00am temperature = 50"
	Dim method As String = "POST"
	Dim client As WebClient = New WebClient()
	Dim reply As String = client.UploadString(address, method, data)

	Console.WriteLine(reply)
End Sub

Commenti

Prima di caricare la stringa, questo metodo lo converte in un Byte matrice usando la codifica specificata nella Encoding proprietà.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Questo metodo si blocca durante la trasmissione della stringa.This method blocks while the string is transmitted. Per inviare una stringa e continuare l'esecuzione durante l'attesa di risposta del server, usare uno del UploadStringAsync metodi.To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String)

Carica la stringa specificata sulla risorsa specificata utilizzando il metodo specificato.Uploads the specified string to the specified resource, using the specified method.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ method, System::String ^ data);
public string UploadString (Uri address, string method, string data);
member this.UploadString : Uri * string * string -> string
Public Function UploadString (address As Uri, method As String, data As String) As String

Parametri

address
Uri Uri Uri Uri

L'URI della risorsa per ricevere la stringa.The URI of the resource to receive the string. L'URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo method.This URI must identify a resource that can accept a request sent with the method method.

method
String String String String

Il metodo HTTP utilizzato per inviare la stringa alla risorsa.The HTTP method used to send the string to the resource. Se il valore è null, l'impostazione predefinita sarà POST per http e STOR per ftp.If null, the default is POST for http and STOR for ftp.

data
String String String String

Stringa da caricare.The string to be uploaded.

Restituisce

Classe String contenente la risposta inviata dal server.A String containing the response sent by the server.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro data è null.The data parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

In alternativa-or- Non è possibile utilizzare method per inviare contenuto.method cannot be used to send content.

Commenti

Prima di caricare la stringa, questo metodo lo converte in un Byte matrice usando la codifica specificata nella Encoding proprietà.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Questo metodo si blocca durante la trasmissione della stringa.This method blocks while the string is transmitted. Per inviare una stringa e continuare l'esecuzione durante l'attesa di risposta del server, usare uno del UploadStringAsync metodi.To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Si applica a