آموزش ایجاد Code snippet در Microsoft visual studio
#1
Note 
سلام به همه عزیزان
تو این پست میخوایم بدونیم که چطور باید یه Code snippet در VS درست کنیم.

Code snippet چیست؟

همون طور از اسمش پیداست Code snippet ها تکه کد هایی هستند که بصورت فایل های XML ذخیره میشن و به ما این امکان رو میدن تا یه تکه کد رو با زدن دو کلید بنویسیم!.
اگر در ادیتور VS بعد از نوشتن واژه forدو بار دکمه TAB رو فشار بدید میبینید که این تکه کد ظاهر میشه:
[HTML]
for (int i = 0; i < length; i++)
{

}
[/HTML]

بیشتر مواقع این همون کدیه که ما میخوایم چون این دستور ها خیلی در برنامه نویسی استفاده میشن مایکروسافت بصورت پیشفرض اونا رو گذاشته اگر میخواید همه snippet ها رو ببینید کافیه تو ادیتور کلیک راست کرده و Insert Snippet رو بزنید، حالا در لیست ظاهر شده میتونید snippet مورند نظر رو انتخاب کنید تا اضافه بشه.

[ATTACH=CONFIG]382[/ATTACH]

طریقه ایجاد یک Code Snippet:

اما بحث اصلی ما اینه که چطور خودمون code snippet بسازیم؟ مثلا ما زیاد از کد اتصال به دیتابیس استفاده میکنیم در این مواقع ایجاد یه Code Snippet کار رو بری ما خیلی راحت میکنه.

همون طور که گفتم Code Snippet ها در یک فایل XML ذخیره میشن برای ایجاد یک فایل XML مسیر زیر رو دنبال کنید:

کد:
File>New>File...

در پنجره ظاهر شده XML File رو انتحاب کرده و Open رو بزنید.
حالا فایل XML شما باید باز شده باشه در این پنجره پوینتر ماوس رو به انتهای کد فعلی ببرید و کلیک راست کرده Insert Snippet رو انتخاب کرده و در لیست بعدی Snippet رو انتخاب کنید.

[ATTACH=CONFIG]381[/ATTACH]

بعد از انتخاب Snippet یه سری کد XML مثل کد زیر ظاهر میشه:
[HTML]
<?xml version="1.0" encoding="utf-8"?>
<CodeSnippet Format="1.0.0" xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<Header>
<Title>title</Title>
<Author>author</Author>
<Shortcut>shortcut</Shortcut>
<Description>description</Description>
<SnippetTypes>
<SnippetType>SurroundsWith</SnippetType>
<SnippetType>Expansion</SnippetType>
</SnippetTypes>
</Header>
<Snippet>
<Declarations>
<Literal>
<ID>name</ID>
<Default>value</Default>
</Literal>
</Declarations>
<Code Language="XML">
<![CDATA[<test>
<name>$name$</name>
$selected$ $end$</test>]]>
</Code>
</Snippet>
</CodeSnippet>
[/HTML]

اول بهتره قسمت های
title-عنوان snippet
Author-نویسنده snippet
Shortcut-نام snippet در لیست snippet ها
Description- توضیح snippet
رو مشخص کنید.

[ATTACH=CONFIG]384[/ATTACH]

بعد از مراحل بالا باید زبانی که میخواید تکه کد توی اون استفاده بشه رو انتخاب کنید برای این کار باید مقدار Code Language رو تغییر بدید مثلا اگر برای شی شارپ استفاده میکنید باید به این صورت:
کد:
<Code Language="CSharp">
و اگر برای ویزوال بیسیک استفاده میکنید برار:
کد:
<Code Language="VB">
قرار بدید.

بعد مراحل بالا باید کد اصلی رو وارد کنید برای این کار باید کد خودتون رو بین CDATA بذارید:
کد:
<![CDATA[کد ها را اینجا وارد کنید]]>

نمونه کامل شده:
[HTML]
<?xml version="1.0" encoding="utf-8" ?>
<CodeSnippet Format="1.0.0" xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<Header>
<Title>Sql Connection Code Snippet</Title>
<Author>M0N0+W4LL</Author>
<Shortcut>SQLConn</Shortcut>
<Description>Add Sql Connection Code Snippet</Description>
<SnippetTypes>
<SnippetType>SurroundsWith</SnippetType>
<SnippetType>Expansion</SnippetType>
</SnippetTypes>
</Header>
<Snippet>
<Declarations>
<Literal>
<ID>message</ID>
<Default>my function</Default>
</Literal>
</Declarations>
<Code Language="CSharp">
<![CDATA[
SqlConnection con = new SqlConnection();
try
{
con.Open();
SqlCommand cmd = con.CreateCommand();
cmd.CommandText = "";
cmd.Parameters.AddWithValue("", "");
cmd.Parameters.AddWithValue("", "");
cmd.Parameters.AddWithValue("", "");
cmd.ExecuteNonQuery();
}
catch (Exception)
{

throw;
}
finally
{
con.Close();
}]]>
</Code>
</Snippet>
</CodeSnippet>

[/HTML]

در گام بعدی از منوی File گزینه Save <XML File Name>.xml رو انتخاب کنید. در پنجره باز شده Save as type رو روی All Files بذارید و با نام دلخواه و پسوند snippet. ذخیره کنید.
برای اینکه بتونید از این تکه کد استفاده کنید باید اون رو Import کنید برای این کار از منوی Tools گزینه Code Snippet manager رو انتخاب کنید.
در این پنجره گزینه import رو بزنید و snippet خودتون رو Open کنید. در قسمت location باید تعیین که میخواید تکه کد در کدوم قسمت باشه مثلا اگر برای استفاده در سی شارپ هست #Visual C رو انتخاب کنید.

[ATTACH=CONFIG]385[/ATTACH]

بعد طی مراحل بالا میتونید نامی که قسمتShortcut انتخاب کردید رو تایپ کنید و دو بار کلید TAB رو بزنید تا تکه کد اضافه بشه.

موفق باشید.
کپی مطلب تنها با ذکر منبع مجاز است!

پاسخ
ایجاد موضوع جدید   پاسخ به موضوع  

موضوعات مرتبط با این موضوع...
موضوع نویسنده پاسخ بازدید آخرین ارسال
Note درخواست فایل یا کتاب آموزشی mshayan 0 353 15-07-2014 ساعت 18:52
آخرین ارسال: mshayan

کاربرانِ درحال بازدید از این موضوع:   1 مهمان