DataObject.GetFormats Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve una lista de todos los formatos a los que se asocian o a los que se pueden convertir los datos almacenados en este objeto DataObject.
Sobrecargas
| GetFormats() |
Devuelve una lista de todos los formatos a los que se asocian o a los que se pueden convertir los datos almacenados en este objeto DataObject. |
| GetFormats(Boolean) |
Devuelve una lista con todos los formatos a los que están asociados o se pueden convertir los datos almacenados en este objeto DataObject, utilizando un parámetro de conversión automática para determinar si se van a recuperar sólo los formatos de datos nativos o todos los formatos a los que se puedan convertir los datos. |
GetFormats()
Devuelve una lista de todos los formatos a los que se asocian o a los que se pueden convertir los datos almacenados en este objeto DataObject.
public:
virtual cli::array <System::String ^> ^ GetFormats();public virtual string[] GetFormats ();abstract member GetFormats : unit -> string[]
override this.GetFormats : unit -> string[]Public Overridable Function GetFormats () As String()Devoluciones
Una matriz de tipo String, que contiene una lista de todos los formatos admitidos por los datos almacenados en este objeto.
Implementaciones
Ejemplos
En el ejemplo de código siguiente se consulta un DataObject para los formatos asociados a sus datos y los formatos a los que se pueden convertir los datos. La lista resultante se muestra en un cuadro de texto. Este código requiere que textBox1 se haya creado.
private:
void GetAllFormats()
{
// Creates a new data object using a string and the text format.
DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Another string" );
// Gets all the data formats and data conversion formats in the DataObject.
array<String^>^ arrayOfFormats = myDataObject->GetFormats();
// Prints the results.
textBox1->Text = "The format(s) associated with the data are: \n";
for ( int i = 0; i < arrayOfFormats->Length; i++ )
{
textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
}
}
private void GetAllFormats() {
// Creates a new data object using a string and the text format.
DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
// Gets all the data formats and data conversion formats in the DataObject.
String[] arrayOfFormats = myDataObject.GetFormats();
// Prints the results.
textBox1.Text = "The format(s) associated with the data are: " + '\n';
for(int i=0; i<arrayOfFormats.Length; i++)
textBox1.Text += arrayOfFormats[i] + '\n';
}
Private Sub GetAllFormats()
' Creates a new data object using a string and the text format.
Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
' Gets all the data formats and data conversion formats in the DataObject.
Dim arrayOfFormats As String() = myDataObject.GetFormats()
' Prints the results.
textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
Dim i As Integer
For i = 0 To arrayOfFormats.Length - 1
textBox1.Text += arrayOfFormats(i) & ControlChars.Cr
Next i
End Sub
Comentarios
Llame a este método para obtener los formatos de datos admitidos antes de llamar a GetData. Consulte DataFormats para conocer los formatos predefinidos.
Nota
Los datos se pueden convertir a otro formato si se almacenó especificando que se permite la conversión y si el formato solicitado es compatible con el formato almacenado. Por ejemplo, los datos almacenados como Unicode se pueden convertir en texto.
Consulte también
Se aplica a
GetFormats(Boolean)
Devuelve una lista con todos los formatos a los que están asociados o se pueden convertir los datos almacenados en este objeto DataObject, utilizando un parámetro de conversión automática para determinar si se van a recuperar sólo los formatos de datos nativos o todos los formatos a los que se puedan convertir los datos.
public:
virtual cli::array <System::String ^> ^ GetFormats(bool autoConvert);public virtual string[] GetFormats (bool autoConvert);abstract member GetFormats : bool -> string[]
override this.GetFormats : bool -> string[]Public Overridable Function GetFormats (autoConvert As Boolean) As String()Parámetros
- autoConvert
- Boolean
true para recuperar todos los formatos a los que están asociados o se pueden convertir los datos almacenados en este objeto DataObject; false para recuperar sólo los formatos de datos nativos.
Devoluciones
Una matriz de tipo String, que contiene una lista de todos los formatos admitidos por los datos almacenados en este objeto.
Implementaciones
Ejemplos
En el ejemplo de código siguiente se consulta un DataObject para los formatos asociados a sus datos. La primera consulta especifica el autoConvert parámetro como false, por lo que solo se devuelve el formato nativo de los datos. La segunda consulta especifica el autoConvert parámetro como true, por lo que la lista de formatos incluye los formatos a los que se pueden convertir los datos.
Este código requiere que textBox1 se haya creado.
private:
void GetAllFormats2()
{
// Creates a new data object using a string and the text format.
DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Another string" );
// Gets the original data formats in the DataObject.
array<String^>^ arrayOfFormats = myDataObject->GetFormats( false );
// Prints the results.
textBox1->Text = "The format(s) associated with the data are: \n";
for ( int i = 0; i < arrayOfFormats->Length; i++ )
{
textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
}
// Gets the all data formats and data conversion formats for the DataObject.
arrayOfFormats = myDataObject->GetFormats( true );
// Prints the results.
textBox1->Text = String::Concat( textBox1->Text , "The data formats and conversion ",
"format(s) associated with the data are: \n" );
for ( int i = 0; i < arrayOfFormats->Length; i++ )
{
textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
}
}
private void GetAllFormats2() {
// Creates a new data object using a string and the text format.
DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
// Gets the original data formats in the DataObject.
String[] arrayOfFormats = myDataObject.GetFormats(false);
// Prints the results.
textBox1.Text = "The format(s) associated with the data are: " + '\n';
for(int i=0; i<arrayOfFormats.Length; i++)
textBox1.Text += arrayOfFormats[i] + '\n';
// Gets the all data formats and data conversion formats for the DataObject.
arrayOfFormats = myDataObject.GetFormats(true);
// Prints the results.
textBox1.Text += "The data formats and conversion format(s) associated with " +
"the data are: " + '\n';
for(int i=0; i<arrayOfFormats.Length; i++)
textBox1.Text += arrayOfFormats[i] + '\n';
}
Private Sub GetAllFormats2()
' Creates a new data object using a string and the text format.
Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
' Gets the original data formats in the DataObject.
Dim arrayOfFormats As String() = myDataObject.GetFormats(False)
' Prints the results.
textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
Dim i As Integer
For i = 0 To arrayOfFormats.Length - 1
textBox1.Text += arrayOfFormats(i) + ControlChars.Cr
Next i
' Gets the all data formats and data conversion formats for the DataObject.
arrayOfFormats = myDataObject.GetFormats(True)
' Prints the results.
textBox1.Text += "The data formats and conversion format(s) associated with " & _
"the data are: " & ControlChars.Cr
For i = 0 To arrayOfFormats.Length - 1
textBox1.Text += arrayOfFormats(i) + ControlChars.Cr
Next i
End Sub
Comentarios
Llame a este método para obtener los formatos de datos admitidos antes de llamar a GetData. Consulte DataFormats para conocer los formatos predefinidos.
Nota
Los datos se pueden convertir a otro formato si se almacenó especificando que se permite la conversión y si el formato solicitado es compatible con el formato almacenado. Por ejemplo, los datos almacenados como Unicode se pueden convertir en texto.
