C# kod parçacıkları
Visual Studio'da, C# kod dosyalarınıza yaygın olarak kullanılan kod eklemek için kod parçacıkları kullanabilirsiniz. Kod parçacıkları, program kodu yazmayı daha hızlı, daha kolay ve daha güvenilir hale getirebilir.
Genişletme kodu parçacıkları belirtilen ekleme noktalarına eklenir. Surround kod parçacıkları seçili kodun çevresine eklenir ve yalnızca C# ve C++ için kullanılabilir. Kod parçacıklarıyla kod ekleme veya çevreleme yönergeleri için bkz . Kod parçacıkları.
Kod parçacığı başvurusu
Kod parçacıkları C# ve C++'da aynı şekilde çalışır, ancak varsayılan kod parçacıkları kümesi farklıdır. Aşağıdaki C# kod parçacıkları varsayılan olarak Visual Studio'da bulunur:
Ad veya kısayol | Açıklama | Geçerli ekleme konumları |
---|---|---|
#if | bir #if yönergesi ve #endif yönergesi oluşturur. | Hiçbir yere. |
#region | #region yönergesi ve #endregion yönergesi oluşturur. | Hiçbir yere. |
~ | İçeren sınıf için sonlandırıcı (yıkıcı) oluşturur. | Sınıfın içinde. |
öznitelik | öğesinden Attributetüretilen bir sınıf için bir bildirim oluşturur. | Bir ad alanının (genel ad alanı dahil), bir sınıfın veya yapının içinde. |
checked | İşaretli bir blok oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
class | Sınıf bildirimi oluşturur. | Bir ad alanının (genel ad alanı dahil), bir sınıfın veya yapının içinde. |
ctor | Içeren sınıf için bir oluşturucu oluşturur. | Sınıfın içinde. |
Cw | için WriteLinebir çağrı oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
do | Bir do while döngüsü oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
else | If-else bloğu oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
enum | Bir sabit listesi bildirimi oluşturur. | Bir ad alanının (genel ad alanı dahil), bir sınıfın veya yapının içinde. |
equals | sınıfında tanımlanan Object yöntemi geçersiz kılan Equals bir yöntem bildirimi oluşturur. | Bir sınıfın veya yapının içinde. |
özel durum | Bir özel durumdan (Exception varsayılan olarak) türetilen bir sınıf için bir bildirim oluşturur. | Bir ad alanının (genel ad alanı dahil), bir sınıfın veya yapının içinde. |
: | For döngüsü oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
foreach | Bir foreach döngüsü oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
forr | Her yinelemeden sonra döngü değişkenini azalan bir for döngüsü oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
eğer | Bir if bloğu oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
Dizinleyici | Dizin oluşturucu bildirimi oluşturur. | Bir sınıfın veya yapının içinde. |
arabirim | Arabirim bildirimi oluşturur. | Bir ad alanının (genel ad alanı dahil), bir sınıfın veya yapının içinde. |
çağırmak | Bir olayı güvenli bir şekilde çağıran bir blok oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
iterator | Yineleyici oluşturur. | Bir sınıfın veya yapının içinde. |
iterindex | İç içe geçmiş bir sınıf kullanarak bir named yineleyici ve dizin oluşturucu çifti oluşturur. |
Bir sınıfın veya yapının içinde. |
lock | Bir kilit bloğu oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
mbox | için System.Windows.Forms.MessageBox.Showbir çağrı oluşturur. System.Windows.Forms.dll bir başvuru eklemeniz gerekebilir. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
ad alanı | Ad alanı bildirimi oluşturur. | Genel ad alanı da dahil olmak üzere bir ad alanının içinde. |
Pervane | Otomatik olarak önerilen özellik bildirimi oluşturur. | Bir sınıfın veya yapının içinde. |
propfull | ve set erişimcileriyle get bir özellik bildirimi oluşturur. |
Bir sınıfın veya yapının içinde. |
yayma | Özel set erişimci ile salt okunur otomatik bir özellik oluşturur. |
Bir sınıfın veya yapının içinde. |
Sım | Statik bir int Main yöntemi bildirimi oluşturur. | Bir sınıfın veya yapının içinde. |
struct | Bir yapı bildirimi oluşturur. | Bir ad alanının (genel ad alanı dahil), bir sınıfın veya yapının içinde. |
svm | Statik bir geçersiz Main yöntemi bildirimi oluşturur. | Bir sınıfın veya yapının içinde. |
switch | Bir anahtar bloğu oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
Deneme | Try-catch bloğu oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
tryf | Try-finally bloğu oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
unchecked | İşaretlenmemiş bir blok oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
unsafe | Güvenli olmayan bir blok oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
kullanma | Using yönergesi oluşturur. | Genel ad alanı da dahil olmak üzere bir ad alanının içinde. |
while | Bir while döngüsü oluşturur. | Bir yöntemin içinde, dizin oluşturucu, özellik erişimcisi veya olay erişimcisi. |
C# kod parçacığı işlevleri
İşlevler, kod parçacığının İşlev öğesinde belirtilir. Aşağıdaki tabloda, C# kod parçacıklarındaki öğesiyle Function
birlikte kullanılabilecek üç işlev açıklanmaktadır.
İşlev | Açıklama |
---|---|
GenerateSwitchCases(EnumerationLiteral) |
parametresi tarafından EnumerationLiteral belirtilen numaralandırmanın üyeleri için bir switch deyimi ve durum deyimleri kümesi oluşturur. Parametresi, EnumerationLiteral sabit listesi sabit değerine veya sabit listesi türüne başvuru olmalıdır. |
ClassName() |
Eklenen kod parçacığını içeren sınıfın adını döndürür. |
SimpleTypeName(TypeName) |
parametresini TypeName kod parçacığının çağrıldığı bağlamdaki en basit biçimine küçültür. |
GenerateSwitchCases örneği
Aşağıdaki örnekte işlevin nasıl kullanılacağı gösterilmektedir GenerateSwitchCases
. Bu kod parçacığını ekleyip sabit değere $switch_on$
bir sabit listesi girdiğinizde $cases$
, değişmez değer sabit listesi içindeki her değer için bir case
deyim oluşturur.
<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<CodeSnippet Format="1.0.0">
<Header>
<Title>switch</Title>
<Shortcut>switch</Shortcut>
<Description>Code snippet for switch statement</Description>
<Author>Microsoft Corporation</Author>
<SnippetTypes>
<SnippetType>Expansion</SnippetType>
</SnippetTypes>
</Header>
<Snippet>
<Declarations>
<Literal>
<ID>expression</ID>
<ToolTip>Expression to switch on</ToolTip>
<Default>switch_on</Default>
</Literal>
<Literal Editable="false">
<ID>cases</ID>
<Function>GenerateSwitchCases($expression$)</Function>
<Default>default:</Default>
</Literal>
</Declarations>
<Code Language="csharp">
<![CDATA[
switch ($expression$)
{
$cases$
}
]]>
</Code>
</Snippet>
</CodeSnippet>
</CodeSnippets>
ClassName örneği
Aşağıdaki örnekte işlevin nasıl kullanılacağı gösterilmektedir ClassName
. Bu kod parçacığını eklediğinizde değişmez değer, $classname$
kod dosyasındaki bu konumdaki kapsayan sınıfın adıyla değiştirilir.
<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<CodeSnippet Format="1.0.0">
<Header>
<Title>Common constructor pattern</Title>
<Shortcut>ctor</Shortcut>
<Description>Code Snippet for a constructor</Description>
<Author>Microsoft Corporation</Author>
<SnippetTypes>
<SnippetType>Expansion</SnippetType>
</SnippetTypes>
</Header>
<Snippet>
<Declarations>
<Literal>
<ID>type</ID>
<Default>int</Default>
</Literal>
<Literal>
<ID>name</ID>
<Default>field</Default>
</Literal>
<Literal default="true" Editable="false">
<ID>classname</ID>
<ToolTip>Class name</ToolTip>
<Function>ClassName()</Function>
<Default>ClassNamePlaceholder</Default>
</Literal>
</Declarations>
<Code Language="csharp" Format="CData">
<![CDATA[
public $classname$ ($type$ $name$)
{
this._$name$ = $name$;
}
private $type$ _$name$;
]]>
</Code>
</Snippet>
</CodeSnippet>
</CodeSnippets>
SimpleTypeName örneği
Bu örnekte işlevin nasıl kullanılacağı gösterilmektedir SimpleTypeName
. Bu kod parçacığını bir kod dosyasına eklediğinizde değişmez değer, $SystemConsole$
kod parçacığını çağırdığınız bağlamdaki türün en basit biçimiyle Console değiştirilir.
<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<CodeSnippet Format="1.0.0">
<Header>
<Title>Console_WriteLine</Title>
<Shortcut>cw</Shortcut>
<Description>Code snippet for Console.WriteLine</Description>
<Author>Microsoft Corporation</Author>
<SnippetTypes>
<SnippetType>Expansion</SnippetType>
</SnippetTypes>
</Header>
<Snippet>
<Declarations>
<Literal Editable="false">
<ID>SystemConsole</ID>
<Function>SimpleTypeName(global::System.Console)</Function>
</Literal>
</Declarations>
<Code Language="csharp">
<![CDATA[
$SystemConsole$.WriteLine();
]]>
</Code>
</Snippet>
</CodeSnippet>
</CodeSnippets>