DataObject.GetFormats Méthode

Définition

Retourne la liste de tous les formats auxquels les données stockées dans ce DataObject sont associées ou dans lesquels ces données peuvent être converties.Returns a list of all formats that data stored in this DataObject is associated with or can be converted to.

Surcharges

GetFormats()

Retourne la liste de tous les formats auxquels les données stockées dans ce DataObject sont associées ou dans lesquels ces données peuvent être converties.Returns a list of all formats that data stored in this DataObject is associated with or can be converted to.

GetFormats(Boolean)

Retourne la liste de tous les formats auxquels les données stockées dans ce DataObject sont associées ou dans lesquels ces données peuvent être converties, grâce à un paramètre de conversion automatique permettant de déterminer si seuls les formats natifs ou si l'ensemble des formats dans lesquels les données peuvent être converties doivent être récupérés.Returns a list of all formats that data stored in this DataObject is associated with or can be converted to, using an automatic conversion parameter to determine whether to retrieve only native data formats or all formats that the data can be converted to.

GetFormats()

Retourne la liste de tous les formats auxquels les données stockées dans ce DataObject sont associées ou dans lesquels ces données peuvent être converties.Returns a list of all formats that data stored in this DataObject is associated with or can be converted to.

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()

Retours

String[]

Tableau de type String contenant la liste de tous les formats pris en charge par les données stockées dans cet objet.An array of type String, containing a list of all formats that are supported by the data stored in this object.

Implémente

Exemples

L’exemple de code suivant interroge une DataObject pour connaître les formats associés à ses données, ainsi que les formats dans lesquels les données peuvent être converties.The following code example queries a DataObject for the formats associated with its data, and the formats that the data can be converted to. La liste résultante s’affiche dans une zone de texte.The resulting list is displayed in a text box. Ce code requiert la création de textBox1.This code requires that textBox1 has been created.

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

Remarques

Appelez cette méthode pour récupérer les formats de données pris en charge avant d’appeler GetData.Call this method to get the supported data formats before calling GetData. Consultez DataFormats pour obtenir les formats prédéfinis.See DataFormats for the predefined formats.

Notes

Les données peuvent être converties dans un autre format s’il a été stocké, ce qui spécifie que la conversion est autorisée et si le format demandé est compatible avec le format stocké.Data can be converted to another format if it was stored specifying that conversion is allowed and if the requested format is compatible with the stored format. Par exemple, les données stockées au format Unicode peuvent être converties en texte.For example, data stored as Unicode can be converted to text.

Voir aussi

GetFormats(Boolean)

Retourne la liste de tous les formats auxquels les données stockées dans ce DataObject sont associées ou dans lesquels ces données peuvent être converties, grâce à un paramètre de conversion automatique permettant de déterminer si seuls les formats natifs ou si l'ensemble des formats dans lesquels les données peuvent être converties doivent être récupérés.Returns a list of all formats that data stored in this DataObject is associated with or can be converted to, using an automatic conversion parameter to determine whether to retrieve only native data formats or all formats that the data can be converted to.

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()

Paramètres

autoConvert
Boolean

true en cas de récupération de tous les formats auxquels les données stockées dans ce DataObject sont associées ou dans lesquels elles peuvent être converties ; false en cas de récupération des formats de données natifs uniquement.true to retrieve all formats that data stored in this DataObject is associated with, or can be converted to; false to retrieve only native data formats.

Retours

String[]

Tableau de type String contenant la liste de tous les formats pris en charge par les données stockées dans cet objet.An array of type String, containing a list of all formats that are supported by the data stored in this object.

Implémente

Exemples

L’exemple de code suivant interroge une DataObject pour les formats associés à ses données.The following code example queries a DataObject for the formats associated with its data. La première requête spécifie le paramètre autoConvert comme false, de sorte que seul le format natif des données est retourné.The first query specifies the autoConvert parameter as false, so only the native format of the data is returned. La deuxième requête spécifie le paramètre autoConvert comme true, de sorte que la liste des formats comprend les formats dans lesquels les données peuvent être converties.The second query specifies the autoConvert parameter as true, so the list of formats includes the formats that the data can be converted to.

Ce code requiert la création de textBox1.This code requires that textBox1 has been created.

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

Remarques

Appelez cette méthode pour récupérer les formats de données pris en charge avant d’appeler GetData.Call this method to get the supported data formats before calling GetData. Consultez DataFormats pour obtenir les formats prédéfinis.See DataFormats for the predefined formats.

Notes

Les données peuvent être converties dans un autre format s’il a été stocké, ce qui spécifie que la conversion est autorisée et si le format demandé est compatible avec le format stocké.Data can be converted to another format if it was stored specifying that conversion is allowed and if the requested format is compatible with the stored format. Par exemple, les données stockées au format Unicode peuvent être converties en texte.For example, data stored as Unicode can be converted to text.

Voir aussi

S’applique à