SqlConnection.PacketSize Proprietà

Definizione

Spazio dei nomi:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacchetto:

System.Data.SqlClient v4.8.6

Ottiene le dimensioni in byte dei pacchetti di rete usati per comunicare con un'istanza di SQL Server.

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

public int PacketSize { get; }

member this.PacketSize : int

Public ReadOnly Property PacketSize As Integer

Valore della proprietà

Int32

Dimensione in byte dei pacchetti di rete. Il valore predefinito è 8000.

Esempio

Nell'esempio seguente viene creato un SqlConnectionoggetto , inclusa l'impostazione su Packet Size 512 nella stringa di connessione. Visualizza le PacketSize proprietà e ServerVersion nella finestra della console.

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

Commenti

Se un'applicazione esegue operazioni di copia bulk o invia o riceve un sacco di dati di testo o immagine, una dimensione del pacchetto maggiore del valore predefinito può migliorare l'efficienza perché causa un minor numero di operazioni di lettura e scrittura di rete. Se un'applicazione invia e riceve piccole quantità di informazioni, è possibile impostare le dimensioni del pacchetto su 512 byte (usando il valore Dimensioni pacchetti in ConnectionString), che è sufficiente per la maggior parte delle operazioni di trasferimento dei dati. Per la maggior parte delle applicazioni, le dimensioni predefinite risultano ottimali.

PacketSize può essere un valore nell'intervallo di 512 e 32767 byte. Viene generata un'eccezione se il valore non è compreso in questo intervallo.

L'impostazione del valore predefinito su un numero maggiore di 8000 causerà che i pacchetti usino l'allocatore MultiPage nell'istanza di SQL Server anziché l'allocatore SinglePage molto più efficiente, riducendo la scalabilità complessiva del SQL Server. Per altre informazioni su come SQL Server usa la memoria, vedere Guida all'architettura di gestione della memoria.

Vedi anche

• Connessione a un'origine dati in ADO.NET
• Panoramica di ADO.NET