Język

Używanie fragmentów kodu w Visual Studio

Fragmenty kodu to małe bloki kodu wielokrotnego użytku, które można dodać do pliku kodu. Fragmenty kodu zwykle zawierają często używane konstrukcje, takie jak Try...Finally lub If...Else bloki. Możesz również użyć fragmentów kodu, aby dodać całe klasy lub metody.

Fragment kodu zawiera tytuł, którego można użyć do jego wybrania i może zawierać skrót do wpisania, aby go wstawić. Fragmenty kodu mogą również zawierać parametry zastępcze, które działają jako symbole zastępcze. Visual Studio udostępnia fragmenty kodu dla wielu języków, w tym C#, C++i Visual Basic.

Wymagania wstępne

  • Visual Studio z obsługą zainstalowaną dla języka programowania, którego chcesz użyć. Dostępne fragmenty kodu zależą od zainstalowanych obciążeń i składników językowych.
  • Plik kodu otwierany w edytorze i rozpoznawany przez odpowiednią usługę językową. W przykładzie w języku C++ otwórz plik .cpp lub .h.

Omówienie typów fragmentów kodu

Visual Studio obsługuje dwa typy fragmentów kodu:

  • Fragment kodu rozszerzenia dodaje kod w określonym punkcie wstawiania.
  • Fragment kodu surround-with dodaje kod wokół zaznaczonego fragmentu kodu. Fragmenty kodu surround-with są dostępne tylko dla języków C# i C++.

Znajdowanie dostępnych fragmentów kodu

Aby wyświetlić zainstalowane fragmenty kodu dla języka, wybierz pozycję Narzędzia>Menedżer fragmentów kodu lub naciśnij klawisze Ctrl+K, Ctrl+B. W Menedżerze fragmentów kodu wybierz język z listy Język .

Aby utworzyć i zaimportować własny fragment kodu, aby był wyświetlany na liście fragmentów kodu, zobacz Przewodnik: tworzenie fragmentu kodu w programie Visual Studio.

Uwaga / Notatka

Skróty klawiaturowe mogą się różnić w zależności od profilu ustawień, kontekstu, układu klawiatury i niestandardowych powiązań klawiszy. Aby znaleźć powiązanie dla polecenia, zobacz Identyfikowanie i dostosowywanie skrótów klawiaturowych.

Wstaw fragment rozszerzenia

Fragment rozwijany wstawia kod w punkcie wstawiania. Na przykład fragment kodu w języku C# tryf dodaje blok try/finally:

try
{

}
finally
{

}

Musisz wstawić fragment tryf w miejscu, w którym instrukcja jest prawidłowa, na przykład wewnątrz metody, indeksatora, akcesora właściwości lub akcesora zdarzenia.

  1. W edytorze kodu umieść kursor, w którym chcesz dodać fragment kodu.

  2. Wykonaj jedno z następujących działań:

    • Na pasku menu wybierz pozycję Edytuj>IntelliSense>.
    • Kliknij prawym przyciskiem myszy i wybierz pozycję Wstaw>fragment kodu.
    • Naciśnij klawisze Ctrl+K, Ctrl+X.

  3. W selektorze fragmentów otwórz folder Visual C#, a następnie dwukrotnie kliknij tryf. Możesz również wybrać tryf i nacisnąć klawisz Tab lub Enter.

Blok try/finally pojawi się w miejscu wstawienia, gotowy do dostosowania do swoich potrzeb.

Wskazówka

W prawidłowym punkcie wstawiania wpisz tryf, a następnie naciśnij dwukrotnie klawisz Tab , aby rozwinąć fragment kodu bez otwierania selektora fragmentów kodu.

Otaczanie wybranego kodu fragmentem kodu

Fragment „Otocz za pomocą” otacza zaznaczony kod. Na przykład fragment kodu C++ if opakowuje zaznaczony wiersz return FALSE; w if bloku:

if (true)
{
    return FALSE;
}

Aby otoczyć wybrany kod C++:

  1. W pliku .cpp lub .h wybierz kod, który chcesz opakowować.

  2. Wykonaj jedno z następujących działań:

    • Na pasku menu wybierz pozycję Edytuj>IntelliSense>Otocz za pomocą.
    • Kliknij prawym przyciskiem myszy i wybierz pozycję Otocz przez.

  3. W wyborze fragmentów kodu kliknij dwukrotnie if lub wybierz if i naciśnij Tab lub Enter.

Blok if zostanie wyświetlony wokół wybranego kodu. Zastąp symbol zastępczy true warunkiem, który chcesz ocenić.

Aby uzyskać więcej przykładów fragmentów kodu C++, zobacz Fragmenty kodu Visual C++.

Edytowanie pól zastępczych

Fragmenty mogą zawierać pola zastępcze, które można dostosować po wstawieniu. Gdy to samo pole pojawia się więcej niż raz, zmiana jednego wystąpienia zmienia wszystkie połączone wystąpienia. Naciśnij klawisz Tab , aby przejść do następnego pola zastępczego.

Na przykład fragment kodu Visual Basic Definiowanie właściwości zawiera pola powiązane dla zmiennej pomocniczej, nazwy właściwości i typu właściwości. Aby go wstawić:

  1. W pliku kodu języka Visual Basic kliknij prawym przyciskiem myszy w miejscu, w którym chcesz wstawić właściwość, a następnie wybierz polecenie Fragment kodu>Wstaw fragment kodu.
  2. Wybierz Code Patterns>, Właściwości, procedury, zdarzenia>Zdefiniuj właściwość.

Zrzut ekranu selektora fragmentów kodu języka Visual Basic z zaznaczoną opcją „Zdefiniuj właściwość” w sekcji Właściwości, Procedury, Zdarzenia.

Wstawiany jest następujący kod:

Private newPropertyValue As String
Public Property NewProperty() As String
    Get
        Return newPropertyValue
    End Get
    Set(ByVal value As String)
        newPropertyValue = value
    End Set
End Property

Jeśli zmienisz newPropertyValue na m_property, zmieni się każde połączone wystąpienie newPropertyValue. Jeśli zmienisz typ właściwości z String na Integer, każde powiązane wystąpienie String zmieni się na Integer.

Rozwiązywanie problemów z fragmentami kodu

Jeśli fragment kodu lub polecenie nie jest dostępne:

  • Upewnij się, że Visual Studio rozpoznaje plik jako oczekiwany język programowania.
  • Upewnij się, że wymagany pakiet obciążeń lub składnik językowy jest zainstalowany.
  • WMenedżerze fragmentów kodunarzędzi> upewnij się, że fragment kodu został zainstalowany dla wybranego języka.
  • Jeśli skrót klawiaturowy nie działa zgodnie z oczekiwaniami, użyj opcji Zidentyfikuj i dostosuj skróty klawiaturowe , aby wyszukać bieżące powiązanie polecenia.
  • Sprawdź, czy punkt wstawiania jest prawidłowy dla wybranego fragmentu kodu. Na przykład niektóre fragmenty kodu C# są prawidłowe tylko wewnątrz metody lub deklaracji typu. Aby uzyskać prawidłowe lokalizacje wstawiania języka C#, zobacz Fragmenty kodu języka C#.

Przejrzyj kod wstawiony za pomocą fragmentów kodu

Fragment kodu pokazuje podstawowy sposób, aby wykonać zadanie. Przejrzyj i dostosuj wygenerowany kod przed użyciem go w aplikacji. Zastanów się, jak kod obsługuje wyjątki, uzyskuje dostęp do zasobów, weryfikuje dane wejściowe i chroni wpisy tajne.

Traktuj fragmenty kodu pobrane z Internetu, takie jak inny pobrany kod. Pobierz fragmenty kodu tylko z zaufanych źródeł i sprawdź kod i metadane fragmentu kodu przed zaimportowaniem lub uruchomieniem.

W projektach platformy .NET fragment kodu może używać References elementu do dodawania odwołań do projektu. Przejrzyj elementy Imports i References oraz upewnij się, że ufasz zestawom, do których istnieją odwołania. Aby uzyskać więcej informacji, zobacz Importowanie przestrzeni nazw oraz dokumentację schematu fragmentów kodu.

Zobacz także

  • Last updated on