Partilhar via


SqlParameter.Offset Propriedade

Definição

Obtém ou define o deslocamento para a propriedade Value.

public:
 property int Offset { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
public int Offset { get; set; }
public int Offset { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.Offset : int with get, set
member this.Offset : int with get, set
Public Property Offset As Integer

Valor da propriedade

O deslocamento para o Value. O padrão é 0.

Atributos

Exemplos

O exemplo a seguir cria um SqlParameter e define algumas de suas propriedades.

// using Microsoft.Data.SqlClient;
static void CreateSqlParameterOffset()
{
    SqlParameter parameter = new SqlParameter("pDName", SqlDbType.VarChar);
    parameter.IsNullable = true;
    parameter.Offset = 3;
}

Comentários

A Offset propriedade é usada para agrupamento do lado do cliente de dados binários e de cadeia de caracteres. Por exemplo, para inserir 10 MB de texto em uma coluna em um servidor, um usuário pode executar 10 inserções parametrizadas de partes de 1 MB, deslocando o valor de Offset em cada iteração em 1 MB.

Offset especifica o número de bytes para tipos binários e o número de caracteres para cadeias de caracteres. A contagem de cadeias de caracteres não inclui o caractere de terminação.

Aplica-se a