Partager via


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.

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.

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.

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.

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.

Implémente

Exemples

L’exemple de code suivant interroge un DataObject pour les formats associés à ses données et les formats dans lequel les données peuvent être converties. La liste résultante s’affiche dans une zone de texte. Ce code nécessite que l’a textBox1 été créé.

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 obtenir les formats de données pris en charge avant d’appeler GetData. Consultez DataFormats pour connaître les formats prédéfinis.

Notes

Les données peuvent être converties dans un autre format si elles ont été stockées, en spécifiant que la conversion est autorisée et si le format demandé est compatible avec le format stocké. Par exemple, les données stockées en unicode peuvent être converties en texte.

Voir aussi

S’applique à

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.

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.

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.

Implémente

Exemples

L’exemple de code suivant interroge un DataObject pour les formats associés à ses données. La première requête spécifie le autoConvert paramètre comme , de sorte que falseseul le format natif des données est retourné. La deuxième requête spécifie le autoConvert paramètre en tant que true, de sorte que la liste des formats inclut les formats dans lequel les données peuvent être converties.

Ce code nécessite que l’a textBox1 été créé.

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 obtenir les formats de données pris en charge avant d’appeler GetData. Consultez DataFormats pour connaître les formats prédéfinis.

Notes

Les données peuvent être converties dans un autre format si elles ont été stockées, en spécifiant que la conversion est autorisée et si le format demandé est compatible avec le format stocké. Par exemple, les données stockées en unicode peuvent être converties en texte.

Voir aussi

S’applique à