Skip To Content

CoordinateSystem.DatumTransformations (.NET)

Die Methode CoordinateSystem.DatumTransformations gibt alle Datumstransformationen in der Zeichnung als Sammlung von Wörterbüchern zurück.

Die Kombination aus from-Koordinatensystem und to-Koordinatensystem ist in jeder Datumstransformation eindeutig und dient als Schlüsselwert zur Unterscheidung der Datumstransformationen in der Zeichnung. Jede Datumstransformation enthält eine Sammlung der Schritte zum Durchführen der Transformation. Jeder Schritt hat eine Richtung, die angibt, in welcher Reihenfolge der Schritt der Koordinatensystemtransformation angewendet wird.

Deklaration

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

Parameter

TypNameBeschreibungErforderlich

Dokument

doc

Das AutoCAD-Dokument, das bearbeitet werden soll.

Erforderlich

Rückgaben

TypBeschreibung

IEnumerable<Dictionary<Zeichenfolge, Objekt>>

Eine Sammlung von Datumstransformationen in Form von Wörterbüchern. Jede Datumstransformation enthält die folgenden Schlüssel: From, To und Steps. Die Schlüssel From und To haben Zeichenfolgenwerte, die die Koordinatensysteme darstellen. Der Wert des Schlüssels Steps ist eine Sammlung von Wörterbüchern mit Transformationsschritten für Koordinatensysteme. Jedes Wörterbuch mit Transformationsschritten enthält die folgenden Schlüssel Step und Direction. Der Schlüssel Step enthält den Wert des Schritts als Zeichenfolge, und der Schlüssel Direction gibt die Reihenfolge an, in der der Transformationsschritt angewendet wird, entweder "Forward" oder "Reverse".

Anmerkungen zur Fehlermeldung

Diese Methode kann eine Ausnahme auslösen oder null zurückgeben, wenn ein Parameter ungültig ist oder keine Datumstransformationen in der Zeichnung vorhanden sind.

Beispiel

Ausgeben der Datumstransformation in der aktuellen Zeichnung.

// 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
*/

Weitere Informationen

esri_coordsys_DatumTransformations: Eine AutoLISP-Funktion, die alle Datumstransformationen in der Zeichnung als Assoziationsliste zurückgibt.