Фабрики
| Фабричные методы | Описание | Параметры | Пример | Версия |
|---|---|---|---|---|
| Web.Request() | Создает экземпляр WebRequest | var req = Web.Request(); | ||
| Web.Request(host) | Создает экземпляр WebRequest и инициализирует значение свойства Host | host - http адрес хоста | var req = Web.Request("http://microsoft.com/"); |
Свойства
| Свойство | Тип | Описание | Пример | Версия |
|---|---|---|---|---|
| Host | строка | Http адрес хоста | var req = Web.Request(); req.Host = "http://microsoft.com" | |
| UserName | строка | Имя пользователя | req.UserName = "demosr"; | |
| Password | строка | Пароль | req.Password = "demosr"; | |
| Timeout | строка | Таймаут в формате ЧЧ:ММ:СС | req.Timeout = "00:02:00" |
Методы
| Метод | Описание | Параметры | Исключения | Пример | Версия |
|---|---|---|---|---|---|
Get(query) Get(query, callback) Get(query, callback, state) | Отправляет GET запрос на сервер и передает результат в функцию обратного вызова. Результат возвращается в виде строки. | query - get запрос callback - имя функции, вызываемой после успешного выполнения операции или отмены со стороны пользователя; state - объект, передаваемый в функцию обратного вызова в качестве параметра; Функция обратного вызова: (state, args), args - аргументы функции обратного вызова; args.Success - возвращает true, если операция была выполнена успешно args.Result - возвращает результат операции; args.Error - возвращает WebException, в случае ошибки state - объект, переданный в качестве параметра state; | private void MakeWebRequest_OnClick(object sender, EventArgs e) {
var request = new WebRequest();
request.Get("http://microsoft.com/", Callback);
}
private static void Callback(object sender, ResultEventArgs<WebRequest.WebRequestResult> e){
if (!e.Result.Success)
DConsole.WriteLine(e.Result.Error.StatusCode.ToString());
else DConsole.WriteLine(e.Result.Result);
}
| ||
Post(query, data) Post(query, data, callback) Post(query, data, callback, state) | Отправляет данные на сервер методом POST и передает результат в функцию обратного вызова | query - get запрос data - данные строкового типа callback - имя функции, вызываемой после успешного выполнения операции или отмены со стороны пользователя; state - объект, передаваемый в функцию обратного вызова в качестве параметра; Функция обратного вызова: (state, args), args - аргументы функции обратного вызова; args.Success - возвращает true, если операция была выполнена успешно args.Result - возвращает результат операции; args.Error - возвращает WebException, в случае ошибки state - объект, переданный в качестве параметра state; | private void MakeWebRequest_OnClick(object sender, EventArgs e) {
var request = new WebRequest();
request.Post("http://microsoft.com/", "Hello, Microsoft !", Callback);
}
private static void Callback(object sender, ResultEventArgs<WebRequest.WebRequestResult> e){
if (!e.Result.Success)
DConsole.WriteLine(e.Result.Error.StatusCode.ToString());
else DConsole.WriteLine(e.Result.Result);
}
| ||
| AddHeader(name, value) | Добавляет заголовок к запросу | name - имя заголовка value - значение заголовка | - |
WebException
| Свойство | Тип | Описание | Пример | Версия |
|---|---|---|---|---|
| Name | строка | Возвращает имя исключения | private static void Callback(object sender, ResultEventArgs<WebRequest.WebRequestResult> e){
if (!e.Result.Success)
DConsole.WriteLine(e.Result.Error.Name);
else DConsole.WriteLine(e.Result.Result);
}
| |
| Message | строка | Сообщение об ошибке | private static void Callback(object sender, ResultEventArgs<WebRequest.WebRequestResult> e){
if (!e.Result.Success)
DConsole.WriteLine(e.Result.Error.Message);
else DConsole.WriteLine(e.Result.Result);
}
| |
| StatusCode | число | Код ошибки, возвращает -1, если код ошибки не удается получить | private static void Callback(object sender, ResultEventArgs<WebRequest.WebRequestResult> e){
if (!e.Result.Success)
DConsole.WriteLine(e.Result.Error.StatusCode.ToString());
else DConsole.WriteLine(e.Result.Result);
}
|
Добавить комментарий