SqlConnection.PacketSize Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Získá velikost (v bajtech) síťových paketů používaných ke komunikaci s instancí SQL Server.

public:
 property int PacketSize { int get(); };

public int PacketSize { get; }

member this.PacketSize : int

Public ReadOnly Property PacketSize As Integer

Hodnota vlastnosti

Int32

Velikost síťových paketů (v bajtech). Výchozí hodnota je 8000.

Příklady

Následující příklad vytvoří SqlConnectionobjekt , včetně nastavení Packet Size na 512 v připojovacím řetězci. Zobrazí PacketSize vlastnosti a ServerVersion v okně konzoly.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();
            Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
            Console.WriteLine("PacketSize: {0}", connection.PacketSize);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;Packet Size=512";
    }
}

Poznámky

Pokud aplikace provádí operace hromadného kopírování nebo odesílá nebo přijímá velké množství textových nebo obrazových dat, může velikost paketu větší než výchozí hodnota zvýšit efektivitu, protože způsobuje méně síťových operací čtení a zápisu. Pokud aplikace odesílá a přijímá malé množství informací, můžete nastavit velikost paketu na 512 bajtů (pomocí hodnoty Velikost paketu v ConnectionString), která je dostatečná pro většinu operací přenosu dat. Pro většinu aplikací je nejvhodnější výchozí velikost paketů.

PacketSize může být hodnota v rozsahu 512 a 32767 bajtů. Pokud je hodnota mimo tento rozsah, vygeneruje se výjimka.

Nastavení výchozí hodnoty na číslo větší než 8000 způsobí, že pakety budou používat alokátor MultiPage v instanci SQL Server místo mnohem efektivnějšího alokátoru SinglePage, což sníží celkovou škálovatelnost SQL Server. Další informace o tom, jak SQL Server využívá paměť, najdete v tématu Průvodce architekturou správy paměti.