Freigeben über

SqlConnection.PacketSize Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Assemblys:
netstandard.dll, System.Data.SqlClient.dll
Paket:
System.Data.SqlClient v4.8.6

Ruft die Größe der Netzwerkpakete in Bytes ab, die zum Kommunizieren mit einer Instanz von SQL Server verwendet werden.

public:
 property int PacketSize { int get(); };
public int PacketSize { get; }
[System.Data.DataSysDescription("SqlConnection_PacketSize")]
public int PacketSize { get; }
member this.PacketSize : int
[<System.Data.DataSysDescription("SqlConnection_PacketSize")>]
member this.PacketSize : int
Public ReadOnly Property PacketSize As Integer

Eigenschaftswert

Int32

Die Größe von Netzwerkpaketen in Bytes. Der Standardwert ist 8000.

Attribute
DataSysDescriptionAttribute

Beispiele

Im folgenden Beispiel wird ein SqlConnectionerstellt, einschließlich der Packet Size Einstellung auf 512 im Verbindungszeichenfolge. Die Eigenschaften und ServerVersion werden im Konsolenfenster angezeigtPacketSize.

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";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("PacketSize: {0}", connection.PacketSize)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' 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);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;Packet Size=512;"
End Function

Hinweise

Wenn eine Anwendung Massenkopiervorgänge ausführt oder viele Text- oder Bilddaten sendet oder empfängt, kann eine Paketgröße, die größer als die Standardeinstellung ist, die Effizienz verbessern, da sie weniger Lese- und Schreibvorgänge im Netzwerk verursacht. Wenn eine Anwendung kleine Mengen von Informationen sendet und empfängt, können Sie die Paketgröße auf 512 Byte festlegen (unter Verwendung des Werts Paketgröße in ), was für die ConnectionStringmeisten Datenübertragungsvorgänge ausreichend ist. Für die meisten Anwendungen empfiehlt sich die Standardpaketgröße.

PacketSize kann ein Wert im Bereich von 512 und 32767 Bytes sein. Eine Ausnahme wird generiert, wenn der Wert außerhalb dieses Bereichs liegt.

Wenn Sie den Standardwert auf eine Zahl größer als 8000 festlegen, verwenden die Pakete die MultiPage-Zuweisung auf der instance von SQL Server anstelle der viel effizienteren SinglePage-Zuweisung, wodurch die Gesamtskalierbarkeit der SQL Server verringert wird. Weitere Informationen dazu, wie SQL Server Arbeitsspeicher verwendet, finden Sie im Handbuch zur Architektur der Speicherverwaltung.

Gilt für:

Weitere Informationen