CoordinateSystem.DatumTransformations (.NET)

La méthode CoordinateSystem.DatumTransformations renvoie toutes les définitions de transformation de datum figurant dans le dessin sous forme d’une collection de dictionnaires.

La combinaison du système de coordonnées from et du système de coordonnées to incluse dans chaque définition de transformation de datum est unique et fait office de valeurs de clé qui distinguent une définition de transformation de datum d’une autre dans le dessin. Chaque définition de transformation de datum inclut une collection d’étapes pour procéder à la transformation. Chaque étape comporte une direction qui indique l’ordre dans lequel l’étape de la transformation du système de coordonnées est appliquée.

Déclaration

public IEnumerable<Dictionary<string, object>> Esri.ArcGISForAutoCAD.CoordinateSystem.DatumTransformations(Document doc)

Paramètres

Type	Nom	Description	Requis
Document	doc	Document AutoCAD sur lequel intervenir.	required

Retours

Type

Description

IEnumerable<Dictionary<chaîne, objet>>

Collection des définitions de transformation de datum sous forme de dictionnaires. Chaque dictionnaire de définition de transformation de datum contient les clés suivantes : From, To et Steps. Les clés From et To contiennent des valeurs de chaîne représentant les systèmes de coordonnées. La valeur de la clé Steps est une collection de dictionnaires contenant les étapes de la transformation du système de coordonnées. Chaque dictionnaire d’étape de transformation contient les clés Step et Direction. La clé Step comporte une valeur de l’étape sous forme de chaîne et la clé Direction indique l’ordre, "Forward" ou "Reverse", dans lequel l’étape de transformation sera appliquée.

Remarques sur les conditions d’erreur

Si un paramètre n’est pas valide ou s’il n’existe aucune transformation de datum dans le dessin, cette méthode peut générer une exception ou renvoyer null.

Exemple

Afficher les définitions de transformation de datum dans le dessin actuel.

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;

// Get the datum transformations
var datumTransformations = Esri.ArcGISForAutoCAD.CoordinateSystem.DatumTransformations(doc);

// Print the datum transformation definitions
foreach (var dT in datumTransformations)
{
  doc.Editor.WriteMessage("\nFrom {0}: To {1}", dT["From"], dT["To"]);
  doc.Editor.WriteMessage("\nSteps: ");
  doc.Editor.WriteMessage("\n");
  foreach (var dict in dT["Steps"] as List<Dictionary<string, object>>)
  {
    foreach (var kvp in dict)
    {
      doc.Editor.WriteMessage("\t{0}: {1}\n", kvp.Key, kvp.Value.ToString());
    }
  }
}

/* Example output 
From 2882: To 3857
Steps:
 Direction: Forward
 Step: 1901
From 3857: To 4432
Steps:
 Direction: Reverse
 Step: 1173
 Direction: Forward
 Step: 1241
*/

Voir aussi

esri_coordsys_DatumTransformations : fonction AutoLISP qui renvoie toutes les définitions de transformation de datum figurant dans le dessin sous forme d’une liste de listes associées.