SqlString SqlString SqlString SqlString Struct

Definición

Representa una secuencia de caracteres de longitud variable que se va a almacenar en una base de datos o se va a recuperar de una base de datos.Represents a variable-length stream of characters to be stored in or retrieved from the database. SqlString tiene una estructura de datos subyacente diferente de su correspondiente tipo de datos String de .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
Herencia
Atributos
Implementaciones

Comentarios

String siempre usa el valor predeterminado CultureInfo desde el subproceso actual, pero SqlString contiene su propio identificador de configuración regional y marcadores de comparación.String always uses the default CultureInfo from the current thread, but SqlString contains its own locale Id and compare flags. El resultado de la comparación de dos SqlString estructuras es independiente del sistema operativo y la configuración regional del subproceso actual.The comparison result of two SqlString structures is independent of operating system and current thread locale.

Cuando usas SqlString operadores de comparación, tenga en cuenta que si el LCID de los argumentos son diferentes, las funciones de comparación inician una excepción porque no se pueden comparar.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 ejemplo, la instrucciónFor example, the statement

SqlString mySqlString = new SqlString("abc");  

es equivalente ais equivalent to

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

Constructores

SqlString(String) SqlString(String) SqlString(String) SqlString(String)

Inicializa una nueva instancia de la estructura SqlString utilizando la cadena especificada.Initializes a new instance of the SqlString structure using the specified string.

SqlString(String, Int32) SqlString(String, Int32) SqlString(String, Int32) SqlString(String, Int32)

Inicializa una nueva instancia de la estructura SqlString utilizando la cadena especificada y los valores del identificador de configuración regional.Initializes a new instance of the SqlString structure using the specified string and locale id values.

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

Inicializa una nueva instancia de la estructura SqlString utilizando el identificador de configuración regional, las opciones de comparación y los datos especificados.Initializes a new instance of the SqlString structure using the specified locale id, compare options, and data.

SqlString(String, Int32, SqlCompareOptions) SqlString(String, Int32, SqlCompareOptions) SqlString(String, Int32, SqlCompareOptions) SqlString(String, Int32, SqlCompareOptions)

Inicializa una nueva instancia de la estructura SqlString utilizando la cadena, el identificador de configuración regional y los valores de las opciones de comparación especificados.Initializes a new instance of the SqlString structure using the specified string, locale id, and compare option values.

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

Inicializa una nueva instancia de la clase SqlString.Initializes a new instance of the SqlString class.

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

Inicializa una nueva instancia de la clase SqlString.Initializes a new instance of the SqlString class.

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

Inicializa una nueva instancia de la clase SqlString.Initializes a new instance of the SqlString class.

Campos

BinarySort BinarySort BinarySort BinarySort

Especifica que la ordenación debe basarse en un valor numérico de caracteres y no en un valor alfabético.Specifies that sorts should be based on a characters numeric value instead of its alphabetical value.

BinarySort2 BinarySort2 BinarySort2 BinarySort2

Especifica que la ordenación debe basarse en un valor numérico de caracteres y no en un valor alfabético.Specifies that sorts should be based on a character's numeric value instead of its alphabetical value.

IgnoreCase IgnoreCase IgnoreCase IgnoreCase

Especifica que en las comparaciones de SqlString no debe tenerse en cuenta la distinción entre mayúsculas y minúsculas.Specifies that SqlString comparisons should ignore case.

IgnoreKanaType IgnoreKanaType IgnoreKanaType IgnoreKanaType

Especifica que en la comparación de cadenas no se debe tener en cuenta el tipo Kana.Specifies that the string comparison must ignore the Kana type.

IgnoreNonSpace IgnoreNonSpace IgnoreNonSpace IgnoreNonSpace

Especifica que en las comparaciones de cadenas no deben tenerse en cuenta los caracteres combinables sin espaciado, como los diacríticos.Specifies that the string comparison must ignore non-space combining characters, such as diacritics.

IgnoreWidth IgnoreWidth IgnoreWidth IgnoreWidth

Especifica que en la comparación de cadenas no se debe tener en cuenta el ancho de los caracteres.Specifies that the string comparison must ignore the character width.

Null Null Null Null

Representa una clase DBNull que se puede asignar a esta instancia de la estructura SqlString.Represents a DBNull that can be assigned to this instance of the SqlString structure.

Propiedades

CompareInfo CompareInfo CompareInfo CompareInfo

Obtiene el objeto CompareInfo que define el modo en que se realiza la comparación de cadenas de la estructura SqlString.Gets the CompareInfo object that defines how string comparisons should be performed for this SqlString structure.

CultureInfo CultureInfo CultureInfo CultureInfo

Obtiene la estructura CultureInfo que representa la información sobre la referencia cultural de este objeto SqlString.Gets the CultureInfo structure that represents information about the culture of this SqlString object.

IsNull IsNull IsNull IsNull

Indica si esta estructura SqlString es null.Indicates whether this SqlString structure is null.

LCID LCID LCID LCID

Especifica el idioma y la región geográfica de la estructura SqlString.Specifies the geographical locale and language for the SqlString structure.

SqlCompareOptions SqlCompareOptions SqlCompareOptions SqlCompareOptions

Combinación de uno o varios valores de la enumeración SqlCompareOptions que representan el modo en que SqlString debe compararse con otras estructuras 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 Value Value Value

Obtiene la cadena almacenada en la estructura SqlString.Gets the string that is stored in this SqlString structure. Esta propiedad es de sólo lectura.This property is read-only.

Métodos

Add(SqlString, SqlString) Add(SqlString, SqlString) Add(SqlString, SqlString) Add(SqlString, SqlString)

Concatena dos valores SqlString especificados para crear una nueva estructura SqlString.Concatenates two specified SqlString values to create a new SqlString structure.

Clone() Clone() Clone() Clone()

Crea una copia de este objeto SqlString.Creates a copy of this SqlString object.

CompareOptionsFromSqlCompareOptions(SqlCompareOptions) CompareOptionsFromSqlCompareOptions(SqlCompareOptions) CompareOptionsFromSqlCompareOptions(SqlCompareOptions) CompareOptionsFromSqlCompareOptions(SqlCompareOptions)

Obtiene la enumeración CompareOptions equivalente del valor SqlCompareOptions especificado.Gets the CompareOptions enumeration equivalent of the specified SqlCompareOptions value.

CompareTo(SqlString) CompareTo(SqlString) CompareTo(SqlString) CompareTo(SqlString)

Compara esta instancia de SqlString con el SqlString especificado y devuelve una indicación de los valores relativos.Compares this SqlString instance to the supplied SqlString and returns an indication of their relative values.

CompareTo(Object) CompareTo(Object) CompareTo(Object) CompareTo(Object)

Compara este objeto SqlString con el Object proporcionado y devuelve una indicación de sus valores relativos.Compares this SqlString object to the supplied Object and returns an indication of their relative values.

Concat(SqlString, SqlString) Concat(SqlString, SqlString) Concat(SqlString, SqlString) Concat(SqlString, SqlString)

Concatena las dos estructuras SqlString especificadas.Concatenates the two specified SqlString structures.

Equals(SqlString, SqlString) Equals(SqlString, SqlString) Equals(SqlString, SqlString) Equals(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si son iguales.Performs a logical comparison of the two SqlString operands to determine whether they are equal.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Compara el parámetro del objeto especificado con la propiedad Value del objeto SqlString.Compares the supplied object parameter to the Value property of the SqlString object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtiene el código hash de esta instancia.Gets the hash code for this instance.

GetNonUnicodeBytes() GetNonUnicodeBytes() GetNonUnicodeBytes() GetNonUnicodeBytes()

Obtiene una matriz de bytes, que incluye el contenido del objeto SqlString en formato ANSI.Gets an array of bytes, that contains the contents of the SqlString in ANSI format.

GetUnicodeBytes() GetUnicodeBytes() GetUnicodeBytes() GetUnicodeBytes()

Obtiene una matriz de bytes, que incluye el contenido del objeto SqlString en formato Unicode.Gets an array of bytes, that contains the contents of the SqlString in Unicode format.

GetXsdType(XmlSchemaSet) GetXsdType(XmlSchemaSet) GetXsdType(XmlSchemaSet) GetXsdType(XmlSchemaSet)

Devuelve el lenguaje de definición de esquemas XML (XSD) del objeto XmlSchemaSet especificado.Returns the XML Schema definition language (XSD) of the specified XmlSchemaSet.

GreaterThan(SqlString, SqlString) GreaterThan(SqlString, SqlString) GreaterThan(SqlString, SqlString) GreaterThan(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si el primero es mayor que el segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is greater than the second.

GreaterThanOrEqual(SqlString, SqlString) GreaterThanOrEqual(SqlString, SqlString) GreaterThanOrEqual(SqlString, SqlString) GreaterThanOrEqual(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si el primero es mayor o igual que el 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) LessThan(SqlString, SqlString) LessThan(SqlString, SqlString) LessThan(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si el primero es menor que el segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is less than the second.

LessThanOrEqual(SqlString, SqlString) LessThanOrEqual(SqlString, SqlString) LessThanOrEqual(SqlString, SqlString) LessThanOrEqual(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si el primero es menor o igual que el 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) NotEquals(SqlString, SqlString) NotEquals(SqlString, SqlString) NotEquals(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si no son iguales.Performs a logical comparison of the two SqlString operands to determine whether they are not equal.

ToSqlBoolean() ToSqlBoolean() ToSqlBoolean() ToSqlBoolean()

Convierte esta estructura SqlString en SqlBoolean.Converts this SqlString structure to SqlBoolean.

ToSqlByte() ToSqlByte() ToSqlByte() ToSqlByte()

Convierte esta estructura SqlString en SqlByte.Converts this SqlString structure to SqlByte.

ToSqlDateTime() ToSqlDateTime() ToSqlDateTime() ToSqlDateTime()

Convierte esta estructura SqlString en SqlDateTime.Converts this SqlString structure to SqlDateTime.

ToSqlDecimal() ToSqlDecimal() ToSqlDecimal() ToSqlDecimal()

Convierte esta estructura SqlString en SqlDecimal.Converts this SqlString structure to SqlDecimal.

ToSqlDouble() ToSqlDouble() ToSqlDouble() ToSqlDouble()

Convierte esta estructura SqlString en SqlDouble.Converts this SqlString structure to SqlDouble.

ToSqlGuid() ToSqlGuid() ToSqlGuid() ToSqlGuid()

Convierte esta estructura SqlString en SqlGuid.Converts this SqlString structure to SqlGuid.

ToSqlInt16() ToSqlInt16() ToSqlInt16() ToSqlInt16()

Convierte esta estructura SqlString en SqlInt16.Converts this SqlString structure to SqlInt16.

ToSqlInt32() ToSqlInt32() ToSqlInt32() ToSqlInt32()

Convierte esta estructura SqlString en SqlInt32.Converts this SqlString structure to SqlInt32.

ToSqlInt64() ToSqlInt64() ToSqlInt64() ToSqlInt64()

Convierte esta estructura SqlString en SqlInt64.Converts this SqlString structure to SqlInt64.

ToSqlMoney() ToSqlMoney() ToSqlMoney() ToSqlMoney()

Convierte esta estructura SqlString en SqlMoney.Converts this SqlString structure to SqlMoney.

ToSqlSingle() ToSqlSingle() ToSqlSingle() ToSqlSingle()

Convierte esta estructura SqlString en SqlSingle.Converts this SqlString structure to SqlSingle.

ToString() ToString() ToString() ToString()

Convierte un objeto SqlString en String.Converts a SqlString object to a String.

Operadores

Addition(SqlString, SqlString) Addition(SqlString, SqlString) Addition(SqlString, SqlString) Addition(SqlString, SqlString)

Concatena las dos estructuras SqlString especificadas.Concatenates the two specified SqlString structures.

Equality(SqlString, SqlString) Equality(SqlString, SqlString) Equality(SqlString, SqlString) Equality(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si son iguales.Performs a logical comparison of the two SqlString operands to determine whether they are equal.

Explicit(SqlString to String) Explicit(SqlString to String) Explicit(SqlString to String) Explicit(SqlString to String)

Convierte una estructura SqlString en String.Converts a SqlString to a String

Explicit(SqlSingle to SqlString) Explicit(SqlSingle to SqlString) Explicit(SqlSingle to SqlString) Explicit(SqlSingle to SqlString)

Convierte el parámetro SqlSingle especificado en SqlString.Converts the specified SqlSingle parameter to SqlString.

Explicit(SqlMoney to SqlString) Explicit(SqlMoney to SqlString) Explicit(SqlMoney to SqlString) Explicit(SqlMoney to SqlString)

Convierte el parámetro SqlMoney especificado en SqlString.Converts the specified SqlMoney parameter to SqlString.

Explicit(SqlInt64 to SqlString) Explicit(SqlInt64 to SqlString) Explicit(SqlInt64 to SqlString) Explicit(SqlInt64 to SqlString)

Convierte el parámetro SqlInt64 especificado en SqlString.Converts the specified SqlInt64 parameter to SqlString.

Explicit(SqlInt16 to SqlString) Explicit(SqlInt16 to SqlString) Explicit(SqlInt16 to SqlString) Explicit(SqlInt16 to SqlString)

Convierte el parámetro SqlInt16 especificado en SqlString.Converts the specified SqlInt16 parameter to SqlString.

Explicit(SqlInt32 to SqlString) Explicit(SqlInt32 to SqlString) Explicit(SqlInt32 to SqlString) Explicit(SqlInt32 to SqlString)

Convierte el parámetro SqlInt32 especificado en SqlString.Converts the specified SqlInt32 parameter to SqlString.

Explicit(SqlDouble to SqlString) Explicit(SqlDouble to SqlString) Explicit(SqlDouble to SqlString) Explicit(SqlDouble to SqlString)

Convierte el parámetro SqlDouble especificado en SqlString.Converts the specified SqlDouble parameter to SqlString.

Explicit(SqlDecimal to SqlString) Explicit(SqlDecimal to SqlString) Explicit(SqlDecimal to SqlString) Explicit(SqlDecimal to SqlString)

Convierte el parámetro SqlDecimal especificado en SqlString.Converts the specified SqlDecimal parameter to SqlString.

Explicit(SqlDateTime to SqlString) Explicit(SqlDateTime to SqlString) Explicit(SqlDateTime to SqlString) Explicit(SqlDateTime to SqlString)

Convierte el parámetro SqlDateTime especificado en SqlString.Converts the specified SqlDateTime parameter to SqlString.

Explicit(SqlByte to SqlString) Explicit(SqlByte to SqlString) Explicit(SqlByte to SqlString) Explicit(SqlByte to SqlString)

Convierte la estructura SqlByte especificada en SqlString.Converts the specified SqlByte structure to SqlString.

Explicit(SqlBoolean to SqlString) Explicit(SqlBoolean to SqlString) Explicit(SqlBoolean to SqlString) Explicit(SqlBoolean to SqlString)

Convierte la estructura SqlBoolean especificada en SqlString.Converts the specified SqlBoolean structure to SqlString.

Explicit(SqlGuid to SqlString) Explicit(SqlGuid to SqlString) Explicit(SqlGuid to SqlString) Explicit(SqlGuid to SqlString)

Convierte el parámetro SqlGuid especificado en SqlString.Converts the specified SqlGuid parameter to SqlString.

GreaterThan(SqlString, SqlString) GreaterThan(SqlString, SqlString) GreaterThan(SqlString, SqlString) GreaterThan(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si el primero es mayor que el segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is greater than the second.

GreaterThanOrEqual(SqlString, SqlString) GreaterThanOrEqual(SqlString, SqlString) GreaterThanOrEqual(SqlString, SqlString) GreaterThanOrEqual(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si el primero es mayor o igual que el 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) Implicit(String to SqlString) Implicit(String to SqlString) Implicit(String to SqlString)

Convierte el parámetro String en una estructura SqlString.Converts the String parameter to a SqlString.

Inequality(SqlString, SqlString) Inequality(SqlString, SqlString) Inequality(SqlString, SqlString) Inequality(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si no son iguales.Performs a logical comparison of the two SqlString operands to determine whether they are not equal.

LessThan(SqlString, SqlString) LessThan(SqlString, SqlString) LessThan(SqlString, SqlString) LessThan(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si el primero es menor que el segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is less than the second.

LessThanOrEqual(SqlString, SqlString) LessThanOrEqual(SqlString, SqlString) LessThanOrEqual(SqlString, SqlString) LessThanOrEqual(SqlString, SqlString)

Realiza una comparación lógica de los dos operandos SqlString para determinar si el primero es menor o igual que el segundo.Performs a logical comparison of the two SqlString operands to determine whether the first is less than or equal to the second.

Implementaciones de interfaz explícitas

IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema()

Este miembro admite la infraestructura de .NET Framework y no está prevista su utilización directa desde el código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader)

Este miembro admite la infraestructura de .NET Framework y no está prevista su utilización directa desde el código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter)

Este miembro admite la infraestructura de .NET Framework y no está prevista su utilización directa desde el código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Se aplica a

Consulte también: