SqlString Estrutura

Definição

Representa um fluxo de tamanho variável de caracteres a ser armazenado ou recuperado do banco de dados.Represents a variable-length stream of characters to be stored in or retrieved from the database. SqlString tem uma estrutura de dados subjacente diferente de seu correspondente do tipo de dados String .NET Framework.SqlString has a different underlying data structure from its corresponding .NET Framework String data type.

public value class SqlString : IComparable, System::Data::SqlTypes::INullable, System::Xml::Serialization::IXmlSerializable
[System.Serializable]
public struct SqlString : IComparable, System.Data.SqlTypes.INullable, System.Xml.Serialization.IXmlSerializable
type SqlString = struct
    interface INullable
    interface IXmlSerializable
Public Structure SqlString
Implements IComparable, INullable, IXmlSerializable
Herança
SqlString
Atributos
Implementações

Comentários

Stringsempre usa o padrão CultureInfo do thread atual, mas SqlString contém sua própria ID de localidade e os sinalizadores de comparação.String always uses the default CultureInfo from the current thread, but SqlString contains its own locale Id and compare flags. O resultado da comparação de SqlString duas estruturas é independente do sistema operacional e da localidade do thread atual.The comparison result of two SqlString structures is independent of operating system and current thread locale.

Quando você usa SqlString operadores de comparação, observe que, se os LCIDs de argumentos forem diferentes, as funções de comparação lançarão uma exceção porque não poderão ser comparadas.When you use SqlString comparison operators, note that if the LCIDs of arguments are different, comparison functions throw an exception because they cannot be compared. Por exemplo, a instruçãoFor example, the statement

SqlString mySqlString = new SqlString("abc");  

equivale ais equivalent to

SqlString mySqlString = new SqlString("abc", CultureInfo.CurrentCulture.LCID);  

Construtores

SqlString(Int32, SqlCompareOptions, Byte[])

Inicializa uma nova instância da estrutura SqlString usando a identificação de localidade, as opções de comparação e os dados especificados.Initializes a new instance of the SqlString structure using the specified locale id, compare options, and data.

SqlString(Int32, SqlCompareOptions, Byte[], Boolean)

Inicializa uma nova instância da classe SqlString.Initializes a new instance of the SqlString class.

SqlString(Int32, SqlCompareOptions, Byte[], Int32, Int32)

Inicializa uma nova instância da classe SqlString.Initializes a new instance of the SqlString class.

SqlString(Int32, SqlCompareOptions, Byte[], Int32, Int32, Boolean)

Inicializa uma nova instância da classe SqlString.Initializes a new instance of the SqlString class.

SqlString(String)

Inicializa uma nova instância da estrutura SqlString usando a cadeia de caracteres especificada.Initializes a new instance of the SqlString structure using the specified string.

SqlString(String, Int32)

Inicializa uma nova instância da estrutura SqlString usando os valores de cadeia de caracteres e de identificação de localidade especificados.Initializes a new instance of the SqlString structure using the specified string and locale id values.

SqlString(String, Int32, SqlCompareOptions)

Inicializa uma nova instância da estrutura SqlString usando os valores de cadeia de caracteres, identificação de localidade e opções de comparação especificados.Initializes a new instance of the SqlString structure using the specified string, locale id, and compare option values.

Campos

BinarySort

Especifica que as classificações devem ser baseadas em um valor numérico de caracteres em vez de seu valor alfabético.Specifies that sorts should be based on a characters numeric value instead of its alphabetical value.

BinarySort2

Especifica que as classificações devem ser baseadas em um valor numérico de caracteres em vez de seu valor alfabético.Specifies that sorts should be based on a character's numeric value instead of its alphabetical value.

IgnoreCase

Especifica que comparações SqlString devem ignorar maiúsculas e minúsculas.Specifies that SqlString comparisons should ignore case.

IgnoreKanaType

Especifica que se a comparação de cadeia de caracteres deve ignorar o tipo Kana.Specifies that the string comparison must ignore the Kana type.

IgnoreNonSpace

Especifica que a comparação de cadeia de caracteres deve ignorar caracteres sem espaçamento, como sinais diacríticos.Specifies that the string comparison must ignore non-space combining characters, such as diacritics.

IgnoreWidth

Especifica que a comparação de cadeia de caracteres deve ignorar a largura do caractere.Specifies that the string comparison must ignore the character width.

Null

Representa um DBNull que pode ser atribuído a essa instância da estrutura SqlString.Represents a DBNull that can be assigned to this instance of the SqlString structure.

Propriedades

CompareInfo

Obtém o objeto CompareInfo que define como as comparações de cadeia de caracteres devem ser realizadas nesta estrutura SqlString.Gets the CompareInfo object that defines how string comparisons should be performed for this SqlString structure.

CultureInfo

Obtém a estrutura CultureInfo que representa informações sobre a cultura deste objeto SqlString.Gets the CultureInfo structure that represents information about the culture of this SqlString object.

IsNull

Indica se esta estrutura SqlString é nula.Indicates whether this SqlString structure is null.

LCID

Especifica a localidade geográfica e o idioma para a estrutura SqlString.Specifies the geographical locale and language for the SqlString structure.

SqlCompareOptions

Uma combinação de um ou mais valores de enumeração SqlCompareOptions que representam o modo no qual o SqlString deve ser comparados às outras estruturas SqlString.A combination of one or more of the SqlCompareOptions enumeration values that represent the way in which this SqlString should be compared to other SqlString structures.

Value

Obtém a cadeia de caracteres armazenada nesta estrutura SqlString.Gets the string that is stored in this SqlString structure. Esta propriedade é somente para leitura.This property is read-only.

Métodos

Add(SqlString, SqlString)

Concatena dois valores SqlString especificados para criar uma nova estrutura SqlString.Concatenates two specified SqlString values to create a new SqlString structure.

Clone()

Cria uma cópia deste objeto SqlString.Creates a copy of this SqlString object.

CompareOptionsFromSqlCompareOptions(SqlCompareOptions)

Obtém a enumeração CompareOptions equivalente do valor SqlCompareOptions especificado.Gets the CompareOptions enumeration equivalent of the specified SqlCompareOptions value.

CompareTo(Object)

Compara este objeto SqlString com o Object fornecido e retorna uma indicação de seus valores relativos.Compares this SqlString object to the supplied Object and returns an indication of their relative values.

CompareTo(SqlString)

Compara esta instância SqlString com o SqlString fornecido e retorna uma indicação de seus valores relativos.Compares this SqlString instance to the supplied SqlString and returns an indication of their relative values.

Concat(SqlString, SqlString)

Concatena as duas estruturas SqlString especificadas.Concatenates the two specified SqlString structures.

Equals(Object)

Compara o parâmetro de objeto fornecido com a propriedade Value do objeto SqlString.Compares the supplied object parameter to the Value property of the SqlString object.

Equals(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se eles são iguais.Performs a logical comparison of the two SqlString operands to determine whether they are equal.

GetHashCode()

Obtém o código hash para esta instância.Gets the hash code for this instance.

GetNonUnicodeBytes()

Obtém uma matriz de bytes que tem o conteúdo do SqlString no formato ANSI.Gets an array of bytes, that contains the contents of the SqlString in ANSI format.

GetUnicodeBytes()

Obtém uma matriz de bytes que tem o conteúdo do SqlString no formato Unicode.Gets an array of bytes, that contains the contents of the SqlString in Unicode format.

GetXsdType(XmlSchemaSet)

Retorna a XSD (linguagem de definição de esquema XML) do XmlSchemaSet especificado.Returns the XML Schema definition language (XSD) of the specified XmlSchemaSet.

GreaterThan(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é maior que o segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is greater than the second.

GreaterThanOrEqual(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é maior ou igual ao segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is greater than or equal to the second.

LessThan(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é menor que o segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is less than the second.

LessThanOrEqual(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é menor ou igual ao segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is less than or equal to the second.

NotEquals(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se eles são diferentes.Performs a logical comparison of the two SqlString operands to determine whether they are not equal.

ToSqlBoolean()

Converte esta estrutura SqlString em SqlBoolean.Converts this SqlString structure to SqlBoolean.

ToSqlByte()

Converte esta estrutura SqlString em SqlByte.Converts this SqlString structure to SqlByte.

ToSqlDateTime()

Converte esta estrutura SqlString em SqlDateTime.Converts this SqlString structure to SqlDateTime.

ToSqlDecimal()

Converte esta estrutura SqlString em SqlDecimal.Converts this SqlString structure to SqlDecimal.

ToSqlDouble()

Converte esta estrutura SqlString em SqlDouble.Converts this SqlString structure to SqlDouble.

ToSqlGuid()

Converte esta estrutura SqlString em SqlGuid.Converts this SqlString structure to SqlGuid.

ToSqlInt16()

Converte esta estrutura SqlString em SqlInt16.Converts this SqlString structure to SqlInt16.

ToSqlInt32()

Converte esta estrutura SqlString em SqlInt32.Converts this SqlString structure to SqlInt32.

ToSqlInt64()

Converte esta estrutura SqlString em SqlInt64.Converts this SqlString structure to SqlInt64.

ToSqlMoney()

Converte esta estrutura SqlString em SqlMoney.Converts this SqlString structure to SqlMoney.

ToSqlSingle()

Converte esta estrutura SqlString em SqlSingle.Converts this SqlString structure to SqlSingle.

ToString()

Converte um objeto SqlString em um String.Converts a SqlString object to a String.

Operadores

Addition(SqlString, SqlString)

Concatena as duas estruturas SqlString especificadas.Concatenates the two specified SqlString structures.

Equality(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se eles são iguais.Performs a logical comparison of the two SqlString operands to determine whether they are equal.

Explicit(SqlBoolean to SqlString)

Converte a estrutura SqlBoolean especificada em SqlString.Converts the specified SqlBoolean structure to SqlString.

Explicit(SqlByte to SqlString)

Converte a estrutura SqlByte especificada em SqlString.Converts the specified SqlByte structure to SqlString.

Explicit(SqlDateTime to SqlString)

Converte o parâmetro especificado SqlDateTime em SqlString.Converts the specified SqlDateTime parameter to SqlString.

Explicit(SqlDecimal to SqlString)

Converte o parâmetro especificado SqlDecimal em SqlString.Converts the specified SqlDecimal parameter to SqlString.

Explicit(SqlDouble to SqlString)

Converte o parâmetro especificado SqlDouble em SqlString.Converts the specified SqlDouble parameter to SqlString.

Explicit(SqlGuid to SqlString)

Converte o parâmetro especificado SqlGuid em SqlString.Converts the specified SqlGuid parameter to SqlString.

Explicit(SqlInt16 to SqlString)

Converte o parâmetro especificado SqlInt16 em SqlString.Converts the specified SqlInt16 parameter to SqlString.

Explicit(SqlInt32 to SqlString)

Converte o parâmetro especificado SqlInt32 em SqlString.Converts the specified SqlInt32 parameter to SqlString.

Explicit(SqlInt64 to SqlString)

Converte o parâmetro especificado SqlInt64 em SqlString.Converts the specified SqlInt64 parameter to SqlString.

Explicit(SqlMoney to SqlString)

Converte o parâmetro especificado SqlMoney em SqlString.Converts the specified SqlMoney parameter to SqlString.

Explicit(SqlSingle to SqlString)

Converte o parâmetro especificado SqlSingle em SqlString.Converts the specified SqlSingle parameter to SqlString.

Explicit(SqlString to String)

Converte um SqlString em um StringConverts a SqlString to a String

GreaterThan(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é maior que o segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is greater than the second.

GreaterThanOrEqual(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é maior ou igual ao segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is greater than or equal to the second.

Implicit(String to SqlString)

Converte o parâmetro String em um SqlString.Converts the String parameter to a SqlString.

Inequality(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se eles são diferentes.Performs a logical comparison of the two SqlString operands to determine whether they are not equal.

LessThan(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é menor que o segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is less than the second.

LessThanOrEqual(SqlString, SqlString)

Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é menor ou igual ao segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is less than or equal to the second.

Implantações explícitas de interface

IXmlSerializable.GetSchema()

Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

IXmlSerializable.ReadXml(XmlReader)

Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

IXmlSerializable.WriteXml(XmlWriter)

Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Aplica-se a

Veja também