İzlenecek Yol: Kod Parçacığı Oluşturma

Makale
06/10/2015

Yalnızca birkaç adımda bir kod parçacığı oluşturabilirsiniz.Tüm yapmanız gereken, bir XML dosyası oluşturmak, uygun öğeleri doldurmak ve kodunuzu buna eklemektir.Kodunuza başvurular ve değiştirme parametreleri de ekleyebilirsiniz.Kod parçacığını Kod Parçacıkları Yöneticisindeki İçe Aktar düğmesini kullanarak Visual Studio yüklemenize ekleyebilirsiniz (Araçlar/Kod Parçacıkları Yöneticisi).

İpucu
Kod parçacıklarının nasıl daha kolayca yazılacağı hakkında bilgi için Parçacık Düzenleyicisi gibi topluluk araçları için CodePlex web sitesinde arama yapın.

Parçacık Şablonu

Temel parçacık şablonu aşağıda verilmiştir:

<?xml version="1.0" encoding="utf-8"?>
<CodeSnippets
    xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title></Title>
        </Header>
        <Snippet>
            <Code Language="">
                <![CDATA[]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

Bir kod parçacığı oluşturmak

Visual Studio'da yeni bir XML dosyası oluşturun ve yukarıda gösterilen şablonu ekleyin.
Başlık öğesinde parçacığın başlığını doldurun örn. "Hello World VB".
Kod öğesinin Diller özniteliğinde parçacığın dilini doldurun.Bu örnek için "VB" kullanın.

Örneğin, Kod öğesinin içindeki CDATA bölümüne kod ekleyin:

<Code Language="VB">
    <![CDATA[Console.WriteLine("Hello, World!")]]>
</Code>

Kod parçacığını VBCodeSnippet.snippet olarak kaydedin.

Visual Studio'ya bir Kod Parçacığı eklemek için

Kod Parçacıkları Yöneticisi'ni kullanarak, kendi parçacıklarınızı Visual Studio yüklemenize ekleyebilirsiniz.Kod parçacıkları Yöneticisi'ni açın (Araçlar/Kod Parçacıkları Yöneticisi).
İçeri Aktar düğmesini tıklatın.
Önceki yordamda kod parçacığını kaydettiğiniz konuma gidin ve konumu seçip Aç'ı tıklatın.
Kod Parçacığını İçe Aktar iletişim kutusu açılır ve sağ bölmedeki seçeneklerden parçacığın nereye ekleneceğini seçmenizi ister.Seçeneklerden biri Kod Parçacıklarım olmalıdır.Onu seçin ve Son, ve sonra Tamam'ı tıklatın.
Parçacık aşağıdaki konuma kopyalanır:

%USERPROFILE%\Documents\Visual Studio 2013\Code Snippets\Visual Basic\My Code Snippets
Bir Visual Basic projesi açarak ve kod bir dosyası açarak parçacığınızı test edin.Dosyada, bağlam menüsündeki Kod Parçacığı Ekle'yi ve Kod Parçacıklarım'ı tıklatın.Visual Basic Kod Parçacığım adlı bir parçacık görmelisiniz.Çift tıklatın.
Koda eklenmiş olan Console.WriteLine("Hello, World!") ifadesini görmelisiniz.

Açıklama ve Kısayol Alanları Ekleme

Açıklama alanları, Kod Parçacığı Yöneticisi'nde görüntülendiğinde kodunuzla ilgili daha fazla bilgi verir.Kısayol, parçacık eklemek için kullanıcıların yazabilecekleri bir etikettir.%USERPROFILE%\Documents\Visual Studio 2013\Code Snippets\Visual Basic\My Code Snippet\VBCodeSnippet.snippet dosyasını açarak eklediğiniz parçacığı düzenleyin.
Üstbilgi öğesine Yazar ve Açıklama öğeleri ekleyin ve bunları doldurun.

Üstbilgi öğesi aşağıdakilere benzemelidir:

<Header>
    <Title>Hello World VB</Title>
    <Author>Myself</Author>
    <Description>Says Hello to the world.</Description>
</Header>

Kod Parçacıkları Yöneticisi'ni açın ve kod parçacığınızı seçin.Sağ bölmede açıklama ve yazar alanlarını artık doldurulmuş olduğunu görmelisiniz.

Bir kısayol eklemek için, Yazar ve Açıklama öğesinin yanına bir Kısayol öğesi ekleyin:

<Header>
    <Title>Hello World VB</Title>
    <Author>Myself</Author>
    <Description>Says Hello to the world.</Description>
    <Shortcut>hello</Shortcut>
</Header>

Kod parçacığı dosyasını yeniden kaydedin.
Bir kısayolu sınamak için, bir Visual Basic projesi açın ve bir kod dosyası açın.Dosyaya merhaba yazın ve SEKME tuşuna basın.Kod parçacığı eklenmelidir.

Başvurular ve İçe Aktarmalar eklemek için

Visual Basic parçacıkları ile Başvurular öğesini kullanarak bir projeye başvuru ekleyin ve Almalar öğesini kullanarak bir Almalar bildirimi ekleyin. (Diğer dillerdeki parçacıklar bu özelliğe sahip değildir.) Örneğin, kod örneğindeki Console.WriteLine öğesini MessageBox.Show olarak değiştirirseniz, System.Windows.Forms.dll derlemesini projeye eklemeniz gerekebilir.
Kod parçacığınızı açın.

Parçacık öğesinin altına Başvurular öğesini ekleyin:

<References>
    <Reference>
        <Assembly>System.Windows.Forms.dll</Assembly>
    </Reference>
</References>

Parçacık öğesinin altına İçeri Aktarmalar öğesini ekleyin:

<Imports>
    <Import>
       <Namespace>System.Windows.Forms</Namespace>
    </Import>
</Imports>

CDATA bölümünü şu şekilde değiştirin:

<![CDATA[MessageBox.Show("Hello, World!")]]>

Kod parçacığını kaydedin.
Bir Visual Basic projesi açın ve parçacık ekleyin.
Kod dosyanın üst tarafında bir İçe Aktarmalar deyimi görürsünüz:
```
Imports System.Windows.Forms
```
Projenin özelliklerini arayın.Başvurular sekmesi System.Windows.Forms.dll'e bir başvuru içerir.

Değişiklik Ekleme

Kod parçacıklarınızın bazılarının kullanıcı tarafından değiştirilmesini isteyebilirsiniz (örneğin, bir değişken ekleyip, kullanıcının değişkeni geçerli projedeki bir değişkenle değiştirmesini isteyebilirsiniz.Daha sonra iki tür değişiklik sağlayabilirsiniz: sabit değerler ve nesneler.Değişmez değerler, bazı türdeki (dize değişmez değerleri, değişken adları veya sayısal değerlerin dize halinde temsili) dizelerdir.Nesneler bir dizeden çok bazı tür örnekleridir.Bu yordamda, bir değişmez değer değişikliği ve bir nesne değişikliği bildirecek ve bu değişikliklere başvuruda bulunmak için kodda değişiklik yapacaksınız.
Kod parçacığınızı açın.

Bu örnek, bir SQL bağlantı dizesi kullanır, bu nedenle uygun başvuruları eklemek için İçeri Aktarmalar ve Başvurular öğelerini değiştirmeniz gerekir:

<References>
    <Reference>
        <Assembly>System.Data.dll</Assembly>
    </Reference>
    <Reference>
        <Assembly>System.Xml.dll</Assembly>
    </Reference>
</References>
<Imports>
    <Import>
        <Namespace>System.Data</Namespace>
    </Import>
    <Import>
        <Namespace>System.Data.SqlClient</Namespace>
    </Import>
</Imports>

SQL bağlantı düzesi için sabit içerik değiştirme bildiriminde bulunmak için, Parçacık öğesinin altına bir Bildirimler öğesi ekleyin ve onun içine Kimlik, araç ipucu ve değiştirmeye ilişkin varsayılan değer için alt öğeler içeren bir Sabit değer öğesi ekleyin:
```
<Declarations>
    <Literal>
        <ID>SqlConnString</ID>
        <ToolTip>Replace with a SQL connection string.</ToolTip>
        <Default>"SQL connection string"</Default>
    </Literal>
</Declarations>
```

SQL bağlantısı için bir nesne değiştirme bildiriminde bulunmak için, Bildirimler öğesinin içine bir Nesne öğesi ekleyin ve Kimlik, nesnenin türü, araç ipucu ve varsayılan değer için alt öğeler ekleyin.Elde edilen Bildirimler öğesi şuna benzemelidir:

<Declarations>
    <Literal>
        <ID>SqlConnString</ID>
        <ToolTip>Replace with a SQL connection string.</ToolTip>
        <Default>"SQL connection string"</Default>
    </Literal>
    <Object>
        <ID>SqlConnection</ID>
        <Type>System.Data.SqlClient.SqlConnection</Type>
        <ToolTip>Replace with a connection object in your application.</ToolTip>
        <Default>dcConnection</Default>
    </Object>
</Declarations>

Kod bölümünde, çevreleyen $ işaretleriyle değişikliklere başvurursunuz; örneğin, $replacement$:

<Code Language="VB" Kind="method body">
    <![CDATA[Dim daCustomers As SqlDataAdapter
        Dim selectCommand As SqlCommand

        daCustomers = New SqlClient.SqlDataAdapter()
        selectCommand = new SqlClient.SqlCommand($SqlConnString$)
        daCustomers.SelectCommand = selectCommand
        daCustomers.SelectCommand.Connection = $SqlConnection$]]>
</Code>

Kod parçacığını kaydedin.
Bir Visual Basic projesi açın ve parçacık ekleyin.

Kod aşağıdaki gibi görünmelidir, burada SQL bağlantı dizesi ve dcConnection değişiklikleri açık turuncu vurgulanır.Birinden diğerine gitmek için SEKME tuşuna basın.

Dim daCustomers As SqlDataAdapter
Dim selectCommand As SqlCommand

daCustomers = New SqlClient.SqlDataAdapter()
selectCommand = New SqlClient.SqlCommand("SQL connection string")
daCustomers.SelectCommand = selectCommand
daCustomers.SelectCommand.Connection = dcConnection

Ayrıca bkz.

Kavramlar

Kod Parçacıkları Şema Başvurusu

Aracılığıyla paylaş