IDataObject.GetFormats Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Devuelve una lista de todos los formatos a los que se asocian o a los que pueden convertirse los datos almacenados en esta instancia.

Sobrecargas

GetFormats()	Devuelve una lista de todos los formatos a los que se asocian o a los que pueden convertirse los datos almacenados en esta instancia.
GetFormats(Boolean)	Obtiene una lista con todos los formatos a los que están asociados o se pueden convertir los datos almacenados en esta instancia, usando un valor de tipo booleano para determinar si se recuperarán sólo los formatos de datos nativos o todos los formatos a los que pueden convertirse los datos.

GetFormats()

Devuelve una lista de todos los formatos a los que se asocian o a los que pueden convertirse los datos almacenados en esta instancia.

public:
 cli::array <System::String ^> ^ GetFormats();

public string[] GetFormats ();

abstract member GetFormats : unit -> string[]

Public Function GetFormats () As String()

Devoluciones

String[]

Matriz de nombres que representa una lista de todos los formatos admitidos por los datos almacenados en este objeto.

Ejemplos

En este ejemplo se usa la DataObject clase , que implementa IDataObject, para demostrar el uso del GetFormats método . En primer lugar, crea un objeto de datos (myDataObject) mediante una cadena y el Text formato . A continuación, recupera todos los formatos de datos y los formatos de conversión de datos en el objeto de datos y muestra la lista resultante en un cuadro de mensaje. En este ejemplo se supone que ha creado un Form objeto denominado Form1.

private:
   void GetFormats1()
   {
      // Creates a data object using a string and the Text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"My text string" );
      
      // Gets all the data formats and data conversion formats in the data object.
      array<String^>^allFormats = myDataObject->GetFormats();
      
      // Creates the string that contains the formats.
      String^ theResult = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < allFormats->Length; i++ )
         theResult = theResult + allFormats[ i ] + "\n";
      
      // Displays the result in a message box.
      MessageBox::Show( theResult );
   }

private void GetFormats1() 
{
    // Creates a data object using a string and the Text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "My text string");
 
    // Gets all the data formats and data conversion formats in the data object.
    String[] allFormats = myDataObject.GetFormats();

    // Creates the string that contains the formats.
    string theResult = "The format(s) associated with the data are: " + '\n';
    for(int i = 0; i < allFormats.Length; i++)
        theResult += allFormats[i] + '\n';
    // Displays the result in a message box.
    MessageBox.Show(theResult);
}

Private Sub GetFormats1()
   ' Creates a data object using a string and the Text format.
   Dim myDataObject As New DataObject(DataFormats.Text, "My text string")
   
   ' Gets all the data formats and data conversion formats in the data object.
   Dim allFormats As [String]() = myDataObject.GetFormats()
   
   ' Creates the string that contains the formats.
   Dim theResult As String = "The format(s) associated with the data are: " & _
                vbCr
   Dim i As Integer
   For i = 0 To allFormats.Length - 1
      theResult += allFormats(i) + vbCr
   Next i 
   ' Displays the result in a message box.
   MessageBox.Show(theResult)
End Sub

Comentarios

Llame a este método para obtener los formatos de datos admitidos antes de llamar al GetData método . Consulte la DataFormats clase para conocer los formatos predefinidos.

Nota

Los datos se pueden convertir a otro formato si se almacenó especificando esa 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.

Para obtener una implementación de este método, vea DataObject.GetFormats.

Consulte también

• GetFormats(Boolean)
• GetData(String, Boolean)

GetFormats(Boolean)

Obtiene una lista con todos los formatos a los que están asociados o se pueden convertir los datos almacenados en esta instancia, usando un valor de tipo booleano para determinar si se recuperarán sólo los formatos de datos nativos o todos los formatos a los que pueden convertirse los datos.

public:
 cli::array <System::String ^> ^ GetFormats(bool autoConvert);

public string[] GetFormats (bool autoConvert);

abstract member GetFormats : bool -> string[]

Public Function GetFormats (autoConvert As Boolean) As String()

Parámetros

autoConvert

Boolean

true para recuperar todos los formatos a los que están asociados o a los que pueden convertirse los datos almacenados en esta instancia; false para recuperar sólo los formatos de datos nativos.

Devoluciones

String[]

Matriz de nombres que representa una lista de todos los formatos admitidos por los datos almacenados en este objeto.

Ejemplos

En este ejemplo se usa la DataObject clase , que implementa IDataObject, para demostrar el uso del GetFormats método . En primer lugar, crea un objeto de datos (myDataObject) mediante una cadena y el UnicodeText formato . A continuación, realiza dos consultas para obtener los formatos asociados a los datos. En la primera consulta, establece el autoConvert parámetro false en : en este caso, solo se devuelve el formato nativo de los datos. En la segunda consulta, establece el autoConvert parámetro trueen , de modo que obtiene la lista de formatos, incluidos los formatos a los que se pueden convertir los datos. En cada caso, la lista resultante se muestra en un cuadro de mensaje. En este ejemplo se supone que ha creado un Form objeto denominado Form1.

private:
   void GetFormats2()
   {
      // Creates a new data object using a string and the UnicodeText format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::UnicodeText,"My text string" );
      
      // Gets the original data formats in the data object by setting the automatic
      // conversion parameter to false.
      array<String^>^myFormatsArray = myDataObject->GetFormats( false );
      
      // Stores the results in a string.
      String^ theResult = "The original format associated with the data is:\n";
      for ( int i = 0; i < myFormatsArray->Length; i++ )
         theResult = theResult + myFormatsArray[ i ] + "\n";
      
      // Gets all data formats and data conversion formats for the data object.
      myFormatsArray = myDataObject->GetFormats( true );
      
      // Stores the results in the string.
      theResult = theResult + "\nThe data format(s) and conversion format(s) associated with the data are:\n";
      for ( int i = 0; i < myFormatsArray->Length; i++ )
         theResult = theResult + myFormatsArray[ i ] + "\n";
      
      // Displays the results.
      MessageBox::Show( theResult );
   }

private void GetFormats2() 
{
    // Creates a new data object using a string and the UnicodeText format.
    DataObject myDataObject = new DataObject(DataFormats.UnicodeText, "My text string");

    // Gets the original data formats in the data object by setting the automatic
    // conversion parameter to false.
    String[] myFormatsArray = myDataObject.GetFormats(false);

    // Stores the results in a string.
    string theResult = "The original format associated with the data is:\n";
    for(int i = 0; i < myFormatsArray.Length; i++)
        theResult += myFormatsArray[i] + '\n';

    // Gets all data formats and data conversion formats for the data object.
    myFormatsArray = myDataObject.GetFormats(true);
 
    // Stores the results in the string.
    theResult += "\nThe data format(s) and conversion format(s) associated with " +
        "the data are:\n";
    for(int i = 0; i < myFormatsArray.Length; i++)
        theResult += myFormatsArray[i] + '\n';

    // Displays the results.
    MessageBox.Show(theResult);
}

Private Sub GetFormats2()
   ' Creates a new data object using a string and the UnicodeText format.
   Dim myDataObject As New DataObject(DataFormats.UnicodeText, "My text string")
   
   ' Gets the original data formats in the data object by setting the automatic
   ' conversion parameter to false.
   Dim myFormatsArray As [String]() = myDataObject.GetFormats(False)
   
   ' Stores the results in a string.
   Dim theResult As String = "The original format associated with the data is:" & vbCr
   Dim i As Integer
   For i = 0 To myFormatsArray.Length - 1
      theResult += myFormatsArray(i) + vbCr
   Next i 
   ' Gets all data formats and data conversion formats for the data object.
   myFormatsArray = myDataObject.GetFormats(True)
   
   ' Stores the results in the string.
   theResult += vbCr + "The data format(s) and conversion format(s) associated with " & _
     "the data are:" & vbCr
   For i = 0 To myFormatsArray.Length - 1
      theResult += myFormatsArray(i) + vbCr
   Next i
   ' Displays the results.
   MessageBox.Show(theResult)
End Sub

Comentarios

Llame a este método para obtener los formatos de datos admitidos antes de llamar al GetData método . Consulte la DataFormats clase para conocer los formatos predefinidos.

Nota

Los datos se pueden convertir a otro formato si se almacenó especificando esa 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.

Para obtener una implementación de este método, vea DataObject.GetFormats.

Consulte también

• GetFormats(Boolean)
• GetData(String, Boolean)