WebClient.UploadFile Метод

Определение

Пространство имен:: System.Net

Сборки:: netstandard.dll, System.Net.WebClient.dll

Сборка:: System.Net.WebClient.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Отправляет локальный файл в ресурс с указанным универсальным кодом ресурса (URI).

Перегрузки

Имя	Описание
UploadFile(String, String)	Отправляет указанный локальный файл в ресурс с указанным универсальным кодом ресурса (URI).
UploadFile(Uri, String)	Отправляет указанный локальный файл в ресурс с указанным универсальным кодом ресурса (URI).
UploadFile(String, String, String)	Отправляет указанный локальный файл в указанный ресурс с помощью указанного метода.
UploadFile(Uri, String, String)	Отправляет указанный локальный файл в указанный ресурс с помощью указанного метода.

UploadFile(String, String)

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Отправляет указанный локальный файл в ресурс с указанным универсальным кодом ресурса (URI).

public:
 cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ fileName);

public byte[] UploadFile(string address, string fileName);

member this.UploadFile : string * string -> byte[]

Public Function UploadFile (address As String, fileName As String) As Byte()

Параметры

address: String

URI ресурса для получения файла. Например, ftp://localhost/samplefile.txt.

fileName: String

Файл для отправки в ресурс. Например, "samplefile.txt".

Возвращаемое значение

Byte[]

Массив Byte , содержащий текст ответа из ресурса.

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр fileName имеет значение null.

WebException

URI, сформированный BaseAddressобъединением, и address является недопустимым.

-или-

fileName is null, is Empty, содержит недопустимые символы или не существует.

-или-

Произошла ошибка при отправке файла.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

Заголовок Content-type начинается с multipart.

Примеры

В следующем примере кода отправляется указанный файл в указанный универсальный код ресурса (URI) с помощью UploadFile. На консоли отображается любой ответ, возвращаемый сервером.

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 fully qualified path of the file to be uploaded to the URI" );
String^ fileName = Console::ReadLine();
Console::WriteLine( "Uploading {0} to {1} ...", fileName, uriString );

// Upload the file to the URI.
// The 'UploadFile(uriString, fileName)' method implicitly uses HTTP POST method.
array<Byte>^responseArray = myWebClient->UploadFile( uriString, fileName );

// Decode and display the response.
Console::WriteLine( "\nResponse Received::The contents of the file uploaded are: \n {0}", 
    System::Text::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 fully qualified path of the file to be uploaded to the URI");
string fileName = Console.ReadLine();
Console.WriteLine("Uploading {0} to {1} ...",fileName,uriString);

// Upload the file to the URI.
// The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method.
byte[] responseArray = myWebClient.UploadFile(uriString,fileName);

// Decode and display the response.
Console.WriteLine("\nResponse Received. The contents of the file uploaded are:\n{0}", 
    System.Text.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 fully qualified path of the file to be uploaded to the URI")

Dim fileName As String = Console.ReadLine()
Console.WriteLine("Uploading {0} to {1} ...", fileName, uriString)

' Upload the file to the URI.
' The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method. 
Dim responseArray As Byte() = myWebClient.UploadFile(uriString, fileName)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr & "Response Received. The contents of the file uploaded are: " & _
    ControlChars.Cr & "{0}", System.Text.Encoding.ASCII.GetString(responseArray))

В следующем примере кода показана страница ASP.NET, которая может принимать опубликованные файлы и подходит для использования с методом UploadFile . Страница должна находиться на веб-сервере. Его адрес предоставляет значение параметра addressUploadFile метода.

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="C#" runat=server>
void Page_Load(object sender, EventArgs e) {
    
    foreach(string f in Request.Files.AllKeys) {
        HttpPostedFile file = Request.Files[f];
        file.SaveAs("c:\\inetpub\\test\\UploadedFiles\\" + file.FileName);
    }	
}

</Script>
<html>
<body>
<p> Upload complete.  </p>
</body>
</html>

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="VB" runat=server>
    Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        
        Dim f As String
        Dim file
        For Each f In Request.Files.AllKeys
            file = Request.Files(f)
            file.SaveAs("c:\inetpub\test\UploadedFiles\" & file.FileName)
        Next f
        
    End Sub

</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>

Метод POST определяется HTTP. Если базовый запрос не использует HTTP и POST не понимается сервером, базовые классы протоколов определяют, что происходит. Как правило, WebException создается исключение со свойством Status , которое указывает на ошибку.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.

Применяется к

UploadFile(Uri, String)

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Отправляет указанный локальный файл в ресурс с указанным универсальным кодом ресурса (URI).

public:
 cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ fileName);

public byte[] UploadFile(Uri address, string fileName);

member this.UploadFile : Uri * string -> byte[]

Public Function UploadFile (address As Uri, fileName As String) As Byte()

Параметры

address: Uri

URI ресурса для получения файла. Например, ftp://localhost/samplefile.txt.

fileName: String

Файл для отправки в ресурс. Например, "samplefile.txt".

Возвращаемое значение

Byte[]

Массив Byte , содержащий текст ответа из ресурса.

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр fileName имеет значение null.

WebException

URI, сформированный BaseAddressобъединением, и address является недопустимым.

-или-

fileName is null, is Empty, содержит недопустимые символы или не существует.

-или-

Произошла ошибка при отправке файла.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

Заголовок Content-type начинается с multipart.

Применяется к

UploadFile(String, String, String)

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Отправляет указанный локальный файл в указанный ресурс с помощью указанного метода.

public:
 cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ method, System::String ^ fileName);

public byte[] UploadFile(string address, string? method, string fileName);

public byte[] UploadFile(string address, string method, string fileName);

member this.UploadFile : string * string * string -> byte[]

Public Function UploadFile (address As String, method As String, fileName As String) As Byte()

Параметры

address: String

URI ресурса для получения файла.

method: String

Метод, используемый для отправки файла в ресурс. Если nullзначение по умолчанию — POST для http и STOR для ftp.

fileName: String

Файл для отправки в ресурс.

Возвращаемое значение

Byte[]

Массив Byte , содержащий текст ответа из ресурса.

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр fileName имеет значение null.

WebException

URI, сформированный BaseAddressобъединением, и address является недопустимым.

-или-

fileName is null, is Empty, содержит недопустимые символы или не существует.

-или-

Произошла ошибка при отправке файла.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

Заголовок Content-type начинается с multipart.

Примеры

Console::Write( "\nPlease enter the URL to post data to : " );
String^ uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine
    ("\nPlease enter the fully qualified path of the file to be uploaded to the URL" );
String^ fileName = Console::ReadLine();
Console::WriteLine( "Uploading {0} to {1} ...", fileName, uriString );

// Upload the file to the URL using the HTTP 1.0 POST.
array<Byte>^responseArray = myWebClient->UploadFile( uriString, "POST", fileName );

// Decode and display the response.
Console::WriteLine( "\nResponse Received::The contents of the file uploaded are: \n {0}", 
    System::Text::Encoding::ASCII->GetString( responseArray ));

Console.Write("\nPlease enter the URL to post data to : ");
String uriString = Console.ReadLine();

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

Console.WriteLine("\nPlease enter the fully qualified path of the file to be uploaded to the URL");
string fileName = Console.ReadLine();

Console.WriteLine("Uploading {0} to {1} ...",fileName,uriString);						
// Upload the file to the URL using the HTTP 1.0 POST.
byte[] responseArray = myWebClient.UploadFile(uriString,"POST",fileName);

// Decode and display the response.
Console.WriteLine("\nResponse Received. The contents of the file uploaded are:\n{0}",
    System.Text.Encoding.ASCII.GetString(responseArray));


Console.Write(ControlChars.Cr + "Please enter the URL 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 fully qualified path of the file to be uploaded to the URL")

Dim fileName As String = Console.ReadLine()
Console.WriteLine("Uploading {0} to {1} ...", fileName, uriString)

' Upload the file to the Url using the HTTP 1.0 POST.
Dim responseArray As Byte() = myWebClient.UploadFile(uriString, "POST", fileName)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response Received. The contents of the file uploaded are: " & _
    ControlChars.Cr & "{0}", System.Text.Encoding.ASCII.GetString(responseArray))

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="C#" runat=server>
void Page_Load(object sender, EventArgs e) {
    
    foreach(string f in Request.Files.AllKeys) {
        HttpPostedFile file = Request.Files[f];
        file.SaveAs("c:\\inetpub\\test\\UploadedFiles\\" + file.FileName);
    }	
}

</Script>
<html>
<body>
<p> Upload complete.  </p>
</body>
</html>

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="VB" runat=server>
    Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        
        Dim f As String
        Dim file
        For Each f In Request.Files.AllKeys
            file = Request.Files(f)
            file.SaveAs("c:\inetpub\test\UploadedFiles\" & file.FileName)
        Next f
        
    End Sub

</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>

Если адрес указывает ресурс HTTP, UploadFile метод отправляет локальный файл ресурсу с помощью метода HTTP, указанного в параметре method , и возвращает любой ответ с сервера. Этот метод блокирует отправку файла. Чтобы продолжить выполнение во время ожидания ответа сервера, используйте один из UploadFileAsync методов.

method Если параметр задает команду, которая не понимается сервером или address ресурсом, базовые классы протокола определяют, что происходит. Как правило, WebException создается исключение со свойством Status , которое указывает на ошибку.

Заметка

Применяется к

UploadFile(Uri, String, String)

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Отправляет указанный локальный файл в указанный ресурс с помощью указанного метода.

public:
 cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ method, System::String ^ fileName);

public byte[] UploadFile(Uri address, string? method, string fileName);

public byte[] UploadFile(Uri address, string method, string fileName);

member this.UploadFile : Uri * string * string -> byte[]

Public Function UploadFile (address As Uri, method As String, fileName As String) As Byte()

Параметры

address: Uri

URI ресурса для получения файла.

method: String

Метод, используемый для отправки файла в ресурс. Если nullзначение по умолчанию — POST для http и STOR для ftp.

fileName: String

Файл для отправки в ресурс.

Возвращаемое значение

Byte[]

Массив Byte , содержащий текст ответа из ресурса.

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр fileName имеет значение null.

WebException

URI, сформированный BaseAddressобъединением, и address является недопустимым.

-или-

fileName is null, is Empty, содержит недопустимые символы или не существует.

-или-

Произошла ошибка при отправке файла.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

Заголовок Content-type начинается с multipart.

Применяется к

Кері байланыс

Бет пайдалы болды ма?

Бөлісу құралы:

WebClient.UploadFile Метод

Определение

Перегрузки

UploadFile(String, String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

UploadFile(Uri, String)

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

UploadFile(String, String, String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

UploadFile(Uri, String, String)

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к