Método DataConnectionProperties.ReadValueFromString

Artigo
10/26/2012

Ler um valor da propriedade de uma cadeia de conexão que começa em um índice especificado, convertê-lo para o tipo correto, e atualizá-lo o índice para apontar para uma posição após o nome da propriedade.

Namespace: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (em Microsoft.VisualStudio.Data.dll)

Sintaxe

'Declaração
Protected Overridable Function ReadValueFromString ( _
    propertyName As String, _
    connectionString As String, _
    ByRef index As Integer _
) As Object

protected virtual Object ReadValueFromString(
    string propertyName,
    string connectionString,
    ref int index
)

protected:
virtual Object^ ReadValueFromString(
    String^ propertyName, 
    String^ connectionString, 
    int% index
)

abstract ReadValueFromString : 
        propertyName:string * 
        connectionString:string * 
        index:int byref -> Object 
override ReadValueFromString : 
        propertyName:string * 
        connectionString:string * 
        index:int byref -> Object

protected function ReadValueFromString(
    propertyName : String, 
    connectionString : String, 
    index : int
) : Object

Parâmetros

propertyName
Tipo: System.String
O nome da propriedade para que um valor está sendo lido.

connectionString
Tipo: System.String
A cadeia de conexão que o valor deve ser lido.

index
Tipo: System.Int32%
Índice na cadeia de conexão que para iniciar ler o valor.

Valor de retorno

Tipo: System.Object
Retorna uma subcadeia de caracteres do parâmetro de connectionString que representa o valor da propriedade entre a entrada que inicia o índice e o final do nome de propriedade, convertido para o tipo correto.

Exceções

Exceção	Condição
ArgumentNullException	O parâmetro de name e/ou de connectionString é zero.
FormatException	O formato de cadeia de conexão está vazia.
InvalidCastException	O valor da cadeia de caracteres de leitura não pode ser convertido para o tipo de propriedade.

Comentários

A implementação base do método de Parse chama esse método para analisar a cadeia de conexão de entrada.Usa o parâmetro de index para controlar o local atual na cadeia de caracteres e depende em este método e o método de ReadNameFromString para atualizar adequadamente o índice.

A implementação base faz o seguinte:

Identifica os valores que não são incluídos entre aspas, ou que são incluídos em qualquer aspas simples ou duplas - marcas;
lê até a primeira ocorrência de um caractere separador de entrada de propriedade que não é incluído em qualquer tipo de aspas;
ele então unescapes alguns caracteres inseridas aspas; e
finalmente, tenta converter o valor da cadeia de caracteres no tipo correto para recuperar o descritor da propriedade especificada e usando seu TypeConverter para converter para o tipo correto.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

DataConnectionProperties Classe

Namespace Microsoft.VisualStudio.Data

Partilhar via