SqlConnection.PacketSize Свойство

Определение

Пространство имен:
System.Data.SqlClient
Сборка:
System.Data.SqlClient.dll
Сборка:
System.Data.dll
Исходный код:
System.Data.SqlClient.notsupported.cs

Получает размер (в байтах) сетевых пакетов, используемых для взаимодействия с экземпляром SQL Server.

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

Значение свойства

Int32

Размер (в байтах) сетевых пакетов. Значение по умолчанию — 8000.

Атрибуты
DataSysDescriptionAttribute

Примеры

В следующем примере создается SqlConnection, включая установку Packet Size на 512 в строка подключения. В окне консоли отображаются PacketSize свойства и ServerVersion свойства.

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

Комментарии

Если приложение выполняет операции массового копирования или отправляет или получает большое количество текстовых или графических данных, размер пакета, превышающий значение по умолчанию, может повысить эффективность, так как это приводит к меньшему объему операций чтения и записи в сети. Если приложение отправляет и получает небольшие объемы информации, можно задать размер пакета в 512 байт (используя значение "Размер пакета" в файле ConnectionString), достаточное для большинства операций передачи данных. Для большинства приложений оптимальным является размер пакета, установленный по умолчанию.

PacketSize может быть значением в диапазоне от 512 до 32767 байт. Исключение создается, если значение находится за пределами этого диапазона.

Установка значения по умолчанию больше 8000 приведет к использованию пакетами распределителя MultiPage на экземпляре SQL Server вместо гораздо более эффективного распределителя SinglePage, что снижает общую масштабируемость SQL Server. Дополнительные сведения о том, как SQL Server использует память, см. в руководстве по архитектуре .

Применяется к

См. также раздел