Nyelv

Kódrészletek használata a Visual Studióban

A kódrészletek újrafelhasználható kód kis blokkjai, amelyeket hozzáadhat egy kódfájlhoz. A kódrészletek általában gyakran használt szerkezeteket, például Try...Finally blokkokat If...Else tartalmaznak. A kódrészletekkel teljes osztályokat vagy metódusokat is hozzáadhat.

A kódrészletnek van egy címe, amely alapján kiválaszthatja, és lehet egy billentyűparancsa is, amelynek beírásával beszúrhatja. A kódrészletek helyettesítő paramétereket is tartalmazhatnak, amelyek helyőrzőként működnek. Visual Studio számos nyelvhez biztosít kódrészleteket, például C#, C++ és Visual Basic.

Prerequisites

  • Visual Studio a használni kívánt programozási nyelvhez telepített támogatással. Az elérhető kódrészletek a telepített számítási feladatoktól és nyelvi összetevőktől függnek.
  • Egy kódfájl nyílik meg a szerkesztőben, amelyet a megfelelő nyelvi szolgáltatás ismer fel. A C++-példához nyisson meg egy .h vagy .cpp fájlt.

Kódrészlettípusok ismertetése

Visual Studio kétféle kódrészletet támogat:

  • A bővítő kódrészlet kódot ad hozzá egy megadott beszúrási ponton.
  • A keretes kódrészlet kódot ad hozzá a kijelölt kódhoz. A körülvevő kódrészletek csak a C# és a C++ nyelvhez érhetők el.

Elérhető kódrészletek keresése

Egy nyelv telepített kódrészleteinek megtekintéséhez válassza az Eszközök>kódrészletek kezelője lehetőséget, vagy nyomja le a Ctrl+K, Ctrl+B billentyűkombinációt. A Code Snippets Managerben válasszon egy nyelvet a Nyelv listából.

Ha saját kódrészletet szeretne létrehozni és importálni, hogy az megjelenjen a kódrészletek listájában, tekintse meg az Útmutató: Kódrészlet létrehozása a Visual Studióban című témakört.

Megjegyzés

A billentyűparancsok a beállítások profilja, a környezet, a billentyűzetkiosztás és az egyéni kulcskötések szerint változhatnak. A parancs kötésének megkereséséhez lásd: Billentyűparancsok azonosítása és testreszabása.

Bővítőrészlet beszúrása

A bővítő kódrészlet kódot szúr be a beszúrási ponton. A C# tryf kódrészlet például egy blokkot try/finally ad hozzá:

try
{

}
finally
{

}

Be kell szúrnia a tryf kódrészletet, ahol érvényes egy utasítás, például egy metóduson, indexelőn, tulajdonságkiegészítőn vagy eseménykiegészítőn belül.

  1. A kódszerkesztőben vigye a kurzort oda, ahová hozzá szeretné adni a kódrészletet.

  2. Válasszon a következő lehetőségek közül:

    • A menüsorban válassza a Szerkesztés>IntelliSense> lehetőséget.
    • Kattintson a jobb gombbal, majd válassza a Kódtöredék>Kódtöredék beszúrása elemet.
    • Nyomja le a Ctrl+K, Ctrl+X billentyűkombinációt.
  3. A kódrészletválasztóban nyissa meg a Visual C# mappát, majd kattintson duplán a tryf elemre. A tryf lehetőséget is választhatja, és nyomja le a Tab vagy az Enter billentyűt.

A try/finally blokk megjelenik a beszúrási ponton, készen áll a testreszabásra.

Jótanács

Egy érvényes beszúrási ponton írja be tryf, majd nyomja le kétszer a Tab billentyűt a kódrészlet kibontásához a kódrészletválasztó megnyitása nélkül.

Vegye körül a kijelölt kódot egy kódrészlettel

A kódkörülvevő kódrészlet körülveszi a kijelölt kódot. Például a C++ if kódrészlet a kijelölt sort if egy return FALSE; blokkba foglalja:

if (true)
{
    return FALSE;
}

A kijelölt C++ kód köré helyezéséhez:

  1. A(z) .cpp vagy .h fájlban jelölje ki a körülvenni kívánt kódot.

  2. Válasszon a következő lehetőségek közül:

    • A menüsávon válassza a Szerkesztés>IntelliSense> lehetőséget.
    • Kattintson a jobb gombbal, majd válassza a(z) Surround With lehetőséget.
  3. A kódrészletválasztóban kattintson duplán az if elemre, vagy jelölje ki az if elemet, majd nyomja le a Tab vagy az Enter billentyűt.

A if blokk a kijelölt kód körül jelenik meg. Cserélje le a true helyőrzőt a kiértékelni kívánt feltételre.

További C++ kódrészlet-példákért lásd a Visual C++ kódrészleteket.

Cseremezők szerkesztése

A kódrészletek olyan helyettesítő mezőket tartalmazhatnak, amelyeket a beszúrás után testre szabhat. Ha ugyanaz a mező többször is megjelenik, az egyik előfordulás módosítása az összes csatolt előfordulást megváltoztatja. Nyomja meg a Tab billentyűt, hogy a következő helyettesítési mezőre lépjen.

A Visual Basic Tulajdonságrészlet definiálása például csatolt mezőket tartalmaz a háttérváltozóhoz, a tulajdonságnévhez és a tulajdonságtípushoz. A beszúrásához:

  1. Egy Visual Basic kódfájlban kattintson a jobb gombbal arra a helyre, ahová be szeretné szúrni a tulajdonságot, majd válassza a Kódtöredék>beszúrása elemet.
  2. Válassza ki a Kódminták>tulajdonságait, az eljárásokat, az eseményeket>Határozzon meg egy tulajdonságot.

A Visual Basic kódrészletválasztójának képernyőképe, amelyen a Tulajdonságok, eljárások, események alatt a Tulajdonság definiálása van kiválasztva.

A szöveg a következő kóddal egészül ki:

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

Ha a(z) newPropertyValue elemet erre módosítja: m_property, akkor a(z) newPropertyValue összes csatolt példánya megváltozik. Ha a tulajdonságtípust Integer-ról String-ra módosítja, a String minden kapcsolt példánya Integer-ra változik.

Kódrészletek hibaelhárítása

Ha egy kódrészlet vagy parancs nem érhető el:

  • Ellenőrizze, hogy Visual Studio felismeri-e a fájlt a várt programozási nyelvként.
  • Ellenőrizze, hogy telepítve van-e a szükséges számítási feladat vagy nyelvi összetevő.
  • Az Eszközök>kódrészletek kezelőjében ellenőrizze, hogy a kódrészlet telepítve van-e a kijelölt nyelvre.
  • Ha egy billentyűparancs nem a várt módon működik, a billentyűparancsok azonosítása és testreszabása segítségével keresse meg a parancs aktuális kötését.
  • Ellenőrizze, hogy a beszúrási pont érvényes-e a kijelölt kódrészletre. Egyes C#-kódrészletek például csak metódus- vagy típusdeklaráción belül érvényesek. Érvényes C#-beszúrási helyekért tekintse meg a C#-kódrészleteket.

A kódrészletekkel beillesztett kód áttekintése

A kódrészlet egy feladat végrehajtásának alapszintű módját mutatja be. Tekintse át és alakítsa át a létrehozott kódot, mielőtt egy alkalmazásban használod. Fontolja meg, hogy a kód hogyan kezeli a kivételeket, hogyan fér hozzá az erőforrásokhoz, hogyan ellenőrzi a bemenetet, és hogyan védi a titkos kulcsokat.

Kezelje az internetről letöltött kódrészleteket, mint a többi letöltött kódot. Csak megbízható forrásokból töltsön le kódrészleteket, és importálás vagy futtatás előtt vizsgálja meg a kódrészletet és annak metaadatait.

A .NET Keretrendszer-projektekben egy kódrészlet használhatja az elemet projekthivatkozások References hozzáadására. Tekintse át az Imports és References elemeket, és győződjön meg arról, hogy megbízik a hivatkozott szerelvényekben. További információ: Névtér importálása és a kódrészletek sémahivatkozása.

Lásd még