SqlConnection.PacketSize SqlConnection.PacketSize SqlConnection.PacketSize SqlConnection.PacketSize Property

Définition

Obtient la taille (en octets) des paquets réseau permettant de communiquer avec une instance de SQL Server.Gets the size (in bytes) of network packets used to communicate with an instance of SQL Server.

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

Valeur de propriété

Taille (en octets) des paquets réseau.The size (in bytes) of network packets. La valeur par défaut est 8000.The default value is 8000.

Exemples

L’exemple suivant crée un SqlConnection, y compris la Packet Size valeur 512 dans la chaîne de connexion.The following example creates a SqlConnection, including setting the Packet Size to 512 in the connection string. Elle affiche les PacketSize propriétés ServerVersion et dans la fenêtre de console.It displays the PacketSize and ServerVersion properties in the console window.

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

Remarques

Si une application effectue des opérations de copie en bloc, ou envoie ou reçoit un grand nombre de données de texte ou d’image, une taille de paquet supérieure à la valeur par défaut peut améliorer l’efficacité, car elle entraîne moins d’opérations de lecture et d’écriture sur le réseau.If an application performs bulk copy operations, or sends or receives lots of text or image data, a packet size larger than the default may improve efficiency because it causes fewer network read and write operations. Si une application envoie et reçoit de petites quantités d’informations, vous pouvez définir la taille du paquet sur 512 octets (à l’aide de la ConnectionStringvaleur de la taille du paquet dans le), ce qui est suffisant pour la plupart des opérations de transfert de données.If an application sends and receives small amounts of information, you can set the packet size to 512 bytes (using the Packet Size value in the ConnectionString), which is sufficient for most data transfer operations. Pour la plupart des applications, la taille de paquet par défaut est la meilleure.For most applications, the default packet size is best.

PacketSizepeut être une valeur comprise entre 512 et 32767 octets.PacketSize may be a value in the range of 512 and 32767 bytes. Une exception est générée si la valeur est en dehors de cette plage.An exception is generated if the value is outside this range.

Si vous définissez la valeur par défaut sur un nombre supérieur à 8000, les paquets utilisent l’allocateur multipage sur l’instance de SQL Server au lieu de l’allocateur SinglePage plus efficace, ce qui réduit l’évolutivité globale de la SQL Server.Setting the default value to a number greater than 8000 will cause the packets to use the MultiPage allocator on the instance of SQL Server instead of the much more efficient SinglePage allocator, reducing the overall scalability of the SQL Server. Pour plus d’informations sur la façon dont SQL Server utilise la mémoire, consultez Guide de l' architecture de gestionde la mémoire.For more information on how SQL Server uses memory, see Memory Management Architecture Guide.

S’applique à

Voir aussi