Sdílet prostřednictvím


fixed – příkaz (Referenční dokumentace jazyka C#)

fixed Prohlášení zabrání přemístění pohyblivé proměnné kolekcí odpadků.fixed Prohlášení je povolen pouze v nebezpečných kontextu.Fixedlze také vytvořit pevnou velikost vyrovnávací paměti.

fixed Příkaz nastaví ukazatel na spravované proměnné a "PIN" této proměnné během provádění příkazu.Bez fixed, ukazatele na pohyblivé spravované proměnné by využití, protože proměnné nelze přemístit nestandardně uvolněné.Kompilátor jazyka C# pouze umožňuje přiřadit ukazatel spravované proměnné fixed prohlášení.

unsafe static void TestMethod()
{

    // Assume that the following class exists. 
    //class Point  
    //{  
    //    public int x; 
    //    public int y;  
    //} 

    // Variable pt is a managed variable, subject to garbage collection.
    Point pt = new Point();

    // Using fixed allows the address of pt members to be taken, 
    // and "pins" pt so that it is not relocated.

    fixed (int* p = &pt.x)
    {
        *p = 1;
    }        

}

Ukazatel můžete inicializovat pomocí matice, řetězec, vyrovnávací paměti pevné velikosti nebo adresa proměnné.Následující příklad ukazuje použití proměnných adresy, pole a řetězce.Další informace o pevné velikosti vyrovnávací paměti viz Vyrovnávací paměti pevné velikosti (Průvodce programováním v C#).

static unsafe void Test2()
{
    Point point = new Point();
    double[] arr = { 0, 1.5, 2.3, 3.4, 4.0, 5.9 };
    string str = "Hello World";

    // The following two assignments are equivalent. Each assigns the address 
    // of the first element in array arr to pointer p. 

    // You can initialize a pointer by using an array. 
    fixed (double* p = arr) { /*...*/ }

    // You can initialize a pointer by using the address of a variable.  
    fixed (double* p = &arr[0]) { /*...*/ }

    // The following assignment initializes p by using a string. 
    fixed (char* p = str) { /*...*/ }

    // The following assignment is not valid, because str[0] is a char,  
    // which is a value, not a variable. 
    //fixed (char* p = &str[0]) { /*...*/ } 


    // You can initialize a pointer by using the address of a variable, such 
    // as point.x or arr[5]. 
    fixed (int* p1 = &point.x)
    {
        fixed (double* p2 = &arr[5])
        {
            // Do something with p1 and p2.
        }
    }
}

Více ukazatelů možné inicializovat tak dlouho, dokud nebudou všechny stejného typu.

fixed (byte* ps = srcarray, pd = dstarray) {...}

Chcete-li inicializovat různé typy ukazatele stačí vnořit fixed příkazy, jak ukazuje následující příklad.

fixed (int* p1 = &point.x)
{
    fixed (double* p2 = &arr[5])
    {
        // Do something with p1 and p2.
    }
}

Po spuštění kódu v prohlášení připojených proměnných jsou unpinned a podléhá uvolněné.Proto není příkaz těchto proměnných mimo fixed prohlášení.

[!POZNÁMKA]

Ukazatele inicializována v dlouhodobého prohlášení nelze změnit.

V nebezpečném režimu můžete přidělit paměť v zásobníku, kde není předmětem uvolněné a proto není nutné přidržet.Další informace naleznete v tématu stackalloc.

Příklad

class Point
    { 
        public int x, y; 
    }

    class FixedTest2 
    {
        // Unsafe method: takes a pointer to an int. 
        unsafe static void SquarePtrParam (int* p) 
        {
            *p *= *p;
        }

        unsafe static void Main() 
        {
            Point pt = new Point();
            pt.x = 5;
            pt.y = 6;
            // Pin pt in place: 
            fixed (int* p = &pt.x) 
            {
                SquarePtrParam (p);
            }
            // pt now unpinned.
            Console.WriteLine ("{0} {1}", pt.x, pt.y);
        }
    }
    /*
    Output:
    25 6
     */

Specifikace jazyka C#

Další informace najdete v tématu Specifikace jazyka C#. Specifikace jazyka je úplným a rozhodujícím zdrojem pro syntaxi a použití jazyka C#.

Viz také

Referenční dokumentace

Klíčová slova jazyka C#

unsafe (Referenční dokumentace jazyka C#)

Vyrovnávací paměti pevné velikosti (Průvodce programováním v C#)

Koncepty

Průvodce programováním v C#

Další zdroje

Referenční dokumentace jazyka C#