SqlConnection.PacketSize-Eigenschaft

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

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public ReadOnly Property PacketSize As Integer
'Usage
Dim instance As SqlConnection
Dim value As Integer

value = instance.PacketSize

public int PacketSize { get; }

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

/** @property */
public int get_PacketSize ()

public function get PacketSize () : int

Eigenschaftenwert

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

Hinweise

Wenn eine Anwendung Massenkopiervorgänge ausführt oder große Mengen von Text- oder Bilddaten sendet oder empfängt, kann eine die Standardgröße übersteigende Paketgröße die Effizienz erhöhen, da weniger Lese- und Schreibvorgänge im Netzwerk erforderlich sind. Wenn eine Anwendung kleinere Informationsmengen sendet oder empfängt, können Sie die Paketgröße auf 512 Bytes festlegen (mit dem Packet Size-Wert in ConnectionString). Dieser Wert ist für die meisten Datenübertragungsvorgänge ausreichend. Für die meisten Anwendungen ist die Standardpaketgröße optimal.

PacketSize kann ein Wert zwischen 512 und 32767 Bytes sein. Wenn der Wert außerhalb dieses Bereichs liegt, wird eine Ausnahme generiert.

Beispiel

Im folgenden Beispiel wird eine SqlConnection erstellt, wobei auch in der Verbindungszeichenfolge Packet Size auf 512 festgelegt wird. Außerdem werden die PacketSize-Eigenschaft und die ServerVersion-Eigenschaft im Konsolenfenster angezeigt.

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlConnection-Klasse
SqlConnection-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server