Читать онлайн «C# 4.0 полное руководство - 2011». Страница 262

public byte[]

Записывает информацию из массива data по

UploadData(string address,

адресу URI, обозначаемому параметром address.

byte[] data)

В итоге возвращается ответ

public byte[] UploadData(Uri

Записывает информацию из массива data по

address, byte[] data)

адресу URI, 'обозначаемому параметром address. В итоге возвращается ответ

public byte[]

Записывает информацию из массива data по

UploadData(string address,

адресу URI, обозначаемому параметром address.

string method, byte[] data)

В итоге возвращается ответ. В строке, передаваемой в качестве параметра method, указывается, как именно следует записывать информацию

public byte[] UploadData(Uri

Записывает информацию из массива data по

address, string method,

адресу URI, обозначаемому параметром address.

byte[] data)

В итоге возвращается ответ. В строке, передаваемой в качестве параметра method, указывается, как именно следует записывать информацию

public byte[]

Записывает информацию в файл fileName по

UploadFile(string address,

адресу URI, обозначаемому параметром address.

string fileName)

В итоге возвращается ответ

public byte[] UploadFile(Uri

Записывает информацию в файл fileName по

address, string fileName)

адресу URI, обозначаемому параметром address. В итоге возвращается ответ

Окончание табл. 26.7

Метод

Определение

public byte[]

Записывает информацию в файл fileName по

UploadFile (-string address,

адресу UR1, обозначаемому параметром address.

string method, string

В итоге возвращается ответ. В строке, передавае

fileName)

мой в качестве параметра method, указывается, как именно следует записывать информацию

public byte[] UploadFile(Uri

Записывает информацию в файл fileName по

address, string method,

адресу URI, обозначаемому параметром address.

string fileName)

В итоге возвращается ответ. В строке, передаваемой в качестве параметра method, указывается, как именно следует записывать информацию

public string

Записывает строку data по адресу URI, обозначае

UploadString(string address,

мому параметром address. В итоге возвращается

string data)

ответ

public string

Записывает строку data по адресу URI, обозначае

UploadString(Uri address,

мому параметром address. В итоге возвращается

string data)

ответ

public string

Записывает строку data по адресу URI, обозначае

UploadString(string address,

мому параметром address. В итоге возвращается

string method, string data)

ответ. В строке, передаваемой в качестве параметра method, указывается, как именно следует записывать информацию

public string

Записывает строку data по адресу URI, обозначае

UploadString(Uri address,

мому параметром address. В итоге возвращается

string method, string data)

ответ. В строке, передаваемой в качестве параметра method, указывается, как именно следует записывать информацию

public byte[]

Записывает значения из коллекции data по адресу

UploadValues(string address,

URI, обозначаемому параметром address. В итоге

NameValueCollection data)

возвращается ответ

public byte[]

Записывает значения из коллекции data по адресу

UploadValues(Uri address,

URI, обозначаемому параметром address. В итоге

NameValueCollection data)

возвращается ответ

public byte[]

Записывает значения из коллекции data по адресу

UploadValues(string

URI, обозначаемому параметром address. В итоге

address, string method,

возвращается ответ. В строке, передаваемой в ка

NameValueCollection data)

честве параметра method, указывается, как именно следует записывать информацию

public byte[]

Записывает значения из коллекции data по адресу

UploadValues(Uri

URI, обозначаемому параметром address. В итоге

address, string method,

возвращается ответ. В строке, передаваемой в ка

NameValueCollection data)

честве параметра method, указывается, как именно следует записывать информацию

В приведенном ниже примере программы демонстрируется применение класса WebClient для загрузки данных в файл по указанному сетевому адресу.

// Использовать класс WebClient для загрузки данных // в файл по указанному сетевому адресу.

using System; using System.Net; using System.10;

class WebClientDemo { static void Main() {

WebClient user = new WebClient(); string uri = "http://www.McGraw-Hill.com"; string fname = "data.txt";

try {

Console.WriteLine("Загрузка данных по адресу " + uri + " в файл " + fname); user.DownloadFile(uri, fname);

} catch (WebException exc) {

Console.WriteLine(exc);

}

Console.WriteLine("Загрузка завершена.");

}

}

Эта программа загружает информацию по адресу www .McGrawHill. com и помещает ее в файл data. txt. Обратите внимание на строки кода этой программы, в которых осуществляется загрузка информации. Изменив символьную строку uri, можно загрузить информацию по любому адресу URI, включая и конкретные файлы, доступные по указываемому URL

Несмотря на то что классы WebRequest и WebResponse предоставляют больше возможностей для управления и доступа к более обширной информации, для многих приложений оказывается достаточно и средств класса WebClient. Этим классом особенно удобно пользоваться в тех случаях, когда требуется только загрузка информации из веб-ресурса. Так, с помощью средств класса WebClient можно получить из Интернета обновленную документацию на приложение.

ПРИЛОЖЕНИЕ Краткий справочник по составлению документирующих комментариев

В языке C# предусмотрено три вида комментариев. К двум первым относятся комментарии // и /* */, а третий основан на дескрипторах языка XML и называется документирующим комментарием. (Иногда его еще называют XML-комментарием.) Однострочный документирующий комментарий начинается с символов III, а многострочный начинается с символов / * * и оканчивается символами */. Строки после символов /** могут начинаться с одного символа *, хотя это и не обязательно. Если все последующие строки многострочного комментария начинаются с символа *, то этот символ игнорируется.

Документирующие комментарии вводятся перед объявлением таких элементов языка С#, как классы, пространства имен, методы, свойства и события. С помощью документирующих комментариев можно вводить в исходный текст программы сведения о самой программе. При компиляции программы документирующие комментарии к ней могут быть помещены в отдельный XML-файл. Кроме того, документирующие комментарии можно использовать в средстве IntelliSense интегрированной среды разработки Visual Studio.

Дескрипторы XML-комментариев

В С# поддерживаются дескрипторы документации в формате XML, сведенные в табл. 1. Большинство дескрипторов XML-комментариев не требует особых пояснений

и действуют подобно всем остальным дескрипторам XML, знакомым многим программистам. Тем не менее дескриптор <list> — сложнее других. Он состоит из двух частей: заголовка и элементов списка. Ниже приведена общая форма дескриптора