Loading…

جزیره برنامه نویسی و توسعه نرم افزار

ارسال کننده: حسین احمدی
حسین احمدی ، بنیانگذار TOSINSO ، توسعه دهنده وب و برنامه نویس ، بیش از 12 سال سابقه فعالیت حرفه ای در سطح کلان ، مشاور ، مدیر پروژه و مدرس نهادهای مالی و اعتباری ، تخصص در پلتفرم دات نت و زبان سی شارپ ، طراحی و توسعه وب ، امنیت نرم افزار ، تحلیل سیستم های اطلاعاتی و داده کاوی ...
ارسال پیام خصوصی
امتیازات این مطلب
نکته: برنامه نویسی شبکه (Network Programming) در سی شارپ :: آشنایی با کلاس HttpClient
یکی از مباحث در زبان های برنامه نویسی مختلف و البته زبان برنامه نویسی سی شارپ برنامه نویسی شبکه است که بوسیله آن می توان در خواست ها را در محیط شبکه ارسال کرد و پاسخ آن را دریافت کرد. برنامه هایی مثل برنامه های ارسال فایل در محیط شبکه، برنامه های گفتگوی آنلاین و ... از جمله برنامه هایی هستند که تحت برنامه نویسی شبکه یا Network Programming قرار میگیرند. در زبان سی شارپ فضای از نام System.Net برای برنامه نویسی شبکه استفاده می شود و کلاس هایی که در این فضای نام و فضاهای نام زیر مجموعه آن قرار دارند به شما کمک می کنند تا بتوانید عملیات هایی که در محیط شبکه باید انجام شوند را پیاده سازی کنید. کلاس های فضای نام System.Net به دو دسته تقسیم می شوند، فضای نام System.Net.Sockets که دسترسی سطح پایین را به عملیات های تحت شبکه در اختیار برنامه نویسی می گذارد و خود فضای نام System.Net که کلاس های سطح بالاتری را در اختیار ما قرار می دهند.

در این مطلب قصد داریم با کلاس HttpClient که در فضای نام System.Net.Http قرار گرفته و برای ارسال درخواست های HTTP و دریافت پاسخ های مبتنی بر آن استفاده می شود آشنا شویم. کلاس HttpClient از کلاس HttpMessageInvoker مشتق شده است که این اجازه را به می دهد تا درخواست ها را به صورت Async ارسال کنیم. به عنوان اولین مثال، در نمونه کد زیر درخواستی به وب سایت ITPro ارسال شده و نتیجه آن را خوانده و در خروجی نمایش می دهیم:

static void Main(string[] args)
{
    GetITProData();
}

public static async void GetITProData()
{
    var httpClient = new System.Net.Http.HttpClient();
    var response = await httpClient.GetAsync("https://tosinso.com");
    var result = await response.Content.ReadAsStringAsync();
    Console.WriteLine(result);
}

همانطور که در کد بالا مشاهده می کنید ابتدا یک شئ از کلاس HttpClient ایجاد کردیم و سپس بوسیله دستور GetAsync درخواستی به سمت آدرس وب سایت ITPro ارسال کردیم، خروجی متد GetAsync شئ ای از نوع HttpResponseMessage است که این شئ خصوصیتی دارد به نام Content، خصوصیت Content از نوع HttpContent است که می توان بوسیله آن نتیجه ای که برای برگردانده شده را بخوانیم که در مثال بالا بوسیله متد ReadAsStringAsync جواب درخواست ارسال شده به سایت ITPro را در قالب رشته خوانده و در خروجی نمایش می دهیم.

دقت کنید که GetAsync با توجه به نوع Reponse ای که سرور به سمت شما برمی گرداند خروجی متفاوتی ایجاد می کند، برای مثال خروجی کد بالا کدهای HTML خواهد بود، ممکن است شما درخواست را به سمت یک آدرس که نتیجه را در قالب json برمیگرداند ارسال کنید و نتیجه خروجی شما یک عبارت json باشد.

ممکن است Reponse ای که برای شما ارسال می شود موفقیت آمیز نباشد، برای بررسی موفق بودن درخواست می توان از خصوصیت IsSuccessStatusCode در کلاس HttpResponseMessage استفاده کنید:

var httpClient = new System.Net.Http.HttpClient();
var response = await httpClient.GetAsync("https://tosinso.com");
if (response.IsSuccessStatusCode)
{
    var result = await response.Content.ReadAsStringAsync();
    Console.WriteLine(result);
}


مشخص کردن Header ها برای ارسال درخواست


گاهی وقت ها برای ارسال درخواست به سمت سرور باید برای درخواست مورد نظر Header هایی را مشخص کرد، برای مثال، فرض کنید که قصد دارید به یک آدرس Api که توسط یک وب سایت ارائه شده یک درخواست ارسال کنید و می بایست به همراه درخواست در قالب Header ها Api Key ای که در اختیار شما قرار گرفته را مشخص کنید. برای مشخص کردن Header برای درخواست ارسالی می توانید از DefaultRequestHeaders استفاده کنید:

var httpClient = new System.Net.Http.HttpClient();
httpClient.DefaultRequestHeaders.Add("ApiKey","{your-api-key}");
var response = await httpClient.GetAsync("https://api.itpro.ir/users/getall");
if (response.IsSuccessStatusCode)
{
    var result = await response.Content.ReadAsStringAsync();
    Console.WriteLine(result);
}

در نمونه کد بالا، فرض شده درخواست به آدرس انتخابی ارسال می شود و در Header درخواست ارسالی یک Header با نام ApiKey اضافه شده. (آدرس نوشته شده فرضیست)

برای کلاس HttpClient متدهای دیگری نیز وجود دارد مانند PostAsync که امکان ارسال درخواست ها را در قالب POST امکان پذیر می کند که در یک مطلب جدگانه در مورد ارسال درخواست های POST صحبت خواهیم کرد.

نویسنده: حسین احمدی
منبع: ITpro
دیدگاه ها
  • ارسال توسط:
  • زمان ارسال: 2 ماه قبل
استاد لطفا این مقالات رو ادامه بدین
ممنون
برای ارسال نظر وارد شوید.