Aracılığıyla paylaş

Yönlendirilmiş Grafik Biçimlendirme Dili (DGML) başvurusu

  • Makale

Yönlendirilmiş Graf İşaretleme Dili (DGML), görselleştirme ve karmaşıklık analizi gerçekleştirmek için kullanılan bilgileri açıklar ve Visual Studio'da kod eşlemelerini kalıcı hale getirmek için kullanılan biçimdir. Hem döngüsel hem de döngüsel olarak yönlendirilmiş grafikleri açıklamak için basit XML kullanır. Yönlendirilmiş bir grafik, bağlantılarla veya kenarlarla bağlanmış bir düğüm kümesidir. Düğümler ve bağlantılar, bir yazılım projesindeki öğeler gibi ağ yapılarını açıklamak için kullanılabilir.

Visual Studio'nun bazı sürümlerinin DGML özelliklerinin yalnızca bir alt kümesini desteklediğini unutmayın. Bkz . Mimari ve modelleme araçları için sürüm desteği.

Not

Bir .dgml dosyasını düzenlerken, IntelliSense her öğe için kullanılabilen öznitelikleri ve değerlerini belirlemenize yardımcı olur. Bir öznitelikte renk belirlemek için "Mavi" gibi genel renklerin adlarını veya "#ffa0b1c3" gibi ARGB onaltılık değerlerini kullanın. DGML Windows Presentation Foundation (WPF) renk tanımı biçimlerinin küçük bir alt kümesini kullanır. Daha fazla bilgi için bkz . Renkler Sınıfı.

DGML söz dizimi

Aşağıdaki tabloda DGML'de kullanılan öğe türleri açıklanmaktadır:

  • <DirectedGraph></DirectedGraph>

    Bu öğe, kod eşlemesi (.dgml) belgesinin kök öğesidir. Diğer tüm DGML öğeleri, bu öğe kapsamı içinde görünür.

    Aşağıdaki liste dahil edebileceğiniz isteğe bağlı öznitelikleri tanımlar:

    Background - Harita arka planının rengi

    BackgroundImage - Harita arka planı olarak kullanılacak görüntü dosyasının konumu.

    GraphDirection - Harita ağaç düzenine ()Sugiyama ayarlandığında, düğümleri bağlantıların çoğunun belirtilen yönde akacak şekilde düzenleyin: TopToBottom, BottomToTop, LeftToRightveya RightToLeft. Bkz . Harita düzenini değiştirme.

    Layout - Haritayı şu düzenlere ayarlayın: None, Sugiyama (ağaç düzeni), ForceDirected (hızlı kümeler) veya DependencyMatrix. Bkz . Harita düzenini değiştirme.

    NeighborhoodDistance - Harita ağaç düzenine veya hızlı küme düzenine ayarlandığında, yalnızca seçili düğümlerden uzakta belirtilen sayıda (1-7) bağlantı olan düğümleri gösterin. Bkz . Harita düzenini değiştirme.

    Örnek:

    <?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" Background="Blue" xmlns="http://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      ...
   </Nodes>
   <Links>
      ...
   </Links>
   <Categories>
      ...
   </Categories>
   <Properties>
      ...
   </Properties>
</DirectedGraph>

  • <Nodes></Nodes>

    Bu isteğe bağlı öğe, eşlemedeki düğümleri tanımlayan öğelerin listesini <Node/> içerir. Daha fazla bilgi için öğesine bakın <Node/> .

    Not

    Bir öğede tanımlanmamış bir düğüme başvurduğunuz zaman <Link/> , eşleme otomatik olarak bir <Node/> öğe oluşturur.

    Örnek:

    <?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="http://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node ... />
   </Nodes>
   <Links>
      <Link ... />
   </Links>
</DirectedGraph>

  • <Node/>

    Bu öğe tek bir düğümü tanımlar. Öğe listesinde görünür <Nodes><Nodes/> .

    Bu öğenin öznitelikleri şunlardır:

    Id- Ayrı bir Label öznitelik belirtilmemişse düğümün benzersiz adı ve özniteliğin Label varsayılan değeri. Bu ad, bağlantının Source başvuruda bulunan veya Target özniteliğiyle eşleşmelidir.

    Aşağıdaki liste, dahil edebileceğiniz isteğe bağlı özniteliklerin bazılarını açıklar:

    Label - Düğümün görünen adı.

    Stil öznitelikleri. Bkz. DGML dosyalarını düzenleyerek kod eşlemelerini özelleştirme.

    Category - Bu özniteliği paylaşan öğeleri tanımlayan bir kategorinin adı. Daha fazla bilgi için öğesine bakın <Category/> .

    Property - Aynı özellik değerine sahip öğeleri tanımlayan bir özelliğin adı. Daha fazla bilgi için öğesine bakın <Property/> .

    Group- Düğüm başka düğümler içeriyorsa, içeriğini göstermek veya Collapsed gizlemek için bu özniteliği Expanded veya olarak ayarlayın. özniteliğini Category="Contains" içeren ve üst düğümü kaynak düğüm olarak, alt düğümü de hedef düğüm olarak belirten bir <Link/> öğe olmalıdır. Bkz. Kod öğelerini gruplandırma.

    Visibility- Bu özniteliği , Hiddenveya Collapsedolarak Visibleayarlayın. kullanır System.Windows.Visibility. Bkz. Düğümleri ve bağlantıları gizleme veya gösterme.

    Reference - Bir belgeye veya URL'ye bağlanmak için bu özniteliği ayarlayın. Bkz. Belgeleri veya URL'leri kod öğelerine ve bağlantılara bağlama.

    Örnek:

    <?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="http://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node Id="Driver" Label="Student" Category="Person" />
      <Node Id="Passenger" Label="Instructor" Category="Person" />
      <Node Id="Car" Label="Car" Category="Automobile" />
      <Node Id="Truck" Label="Truck" Category="Automobile" />
   </Nodes>
   <Links>
      <Link ... />
   </Links>
   <Categories>
      <Category Id="Person" Background="Orange" />
      <Category Id="Automobile" Background="Yellow"/>
   </Categories>
</DirectedGraph>

  • <Links></Links>

    Bu öğe, düğümler arasındaki bağlantıları tanımlayan öğelerin listesini <Link> içerir. Daha fazla bilgi için öğesine bakın <Link/> .

    Örnek:

    <?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="http://schemas.microsoft.com/vs/2009/dgml">
   <Links>
      <Link ... />
   </Links>
</DirectedGraph>

  • <Link/>

    Bu öğe, bir kaynak düğümünü hedef düğüme bağlayan tek bir bağlantıyı tanımlar. Öğe listesinde görünür <Links></Links> .

    Not

    Bu öğe tanımlanmamış bir düğüme başvuruyorsa, eşleme belgesi varsa, otomatik olarak belirtilen özniteliklere sahip bir düğüm oluşturur.

    Bu öğenin öznitelikleri şunlardır:

    Source - Bağlantının kaynak düğümü

    Target - Bağlantının hedef düğümü

    Aşağıdaki liste, dahil edebileceğiniz isteğe bağlı özniteliklerin bazılarını açıklar:

    Label - Bağlantının görünen adı

    Stil öznitelikleri. Bkz. DGML dosyalarını düzenleyerek kod eşlemelerini özelleştirme.

    Category - Bu özniteliği paylaşan öğeleri tanımlayan bir kategorinin adı. Daha fazla bilgi için öğesine bakın <Category/> .

    Property - Aynı özellik değerine sahip öğeleri tanımlayan bir özelliğin adı. Daha fazla bilgi için öğesine bakın <Property/> .

    Örnek:

    <?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="http://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node Id="Driver" Label="Student" Category="Person" />
      <Node Id="Passenger" Label="Instructor" Category="Person" />
      <Node Id="Car" Label="Car" Category="Automobile" />
      <Node Id="Truck" Label="Truck" Category="Automobile" />
   </Nodes>
   <Links>
      <Category Id="Person" Background="Orange" />
      <Category Id="Automobile" Background="Yellow"/>
      <Link Source="Driver" Target="Car" Label="Passed" Stroke="Black" Background="Green" Category="PassedTest" />
      <Link Source="Driver" Target="Truck" Label="Failed" Stroke="Black" Background="Red" Category="PassedTest" />
   </Links>
</DirectedGraph>

  • <Categories></Categories>

    Bu öğe, öğelerin listesini <Category/> içerir. Daha fazla bilgi için öğesine bakın <Category/> .

    Örnek:

    <?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="http://schemas.microsoft.com/vs/2009/dgml">
   <Categories>
       <Category ... />
   </Categories>
</DirectedGraph>

  • <Category/>

    Bu öğe, bu özniteliği paylaşan öğeleri tanımlamak için kullanılan bir Category özniteliği tanımlar. Öznitelik Category , eşleme öğelerini düzenlemek, devralma yoluyla paylaşılan öznitelikler sağlamak veya ek meta veriler tanımlamak için kullanılabilir.

    Bu öğenin öznitelikleri şunlardır:

    Id- Ayrı bir Label öznitelik belirtilmemişse, kategorinin benzersiz adı ve özniteliğin Label varsayılan değeri.

    Aşağıdaki liste, dahil edebileceğiniz isteğe bağlı özniteliklerin bazılarını açıklar:

    Label - Kategori için okuyucu dostu bir ad.

    BasedOn - Geçerli öğenin devraldığı <Category/> üst kategori.

    Bu öğe örneğinde, FailedTest kategori özniteliğini Stroke kategoriden PassedTest devralır. DGML dosyalarını düzenleyerek kod eşlemelerini özelleştirme bölümünde "Hiyerarşik kategoriler oluşturmak için" bölümüne bakın.

    Kategoriler ayrıca düğümlerin ve bağlantıların harita üzerinde görüntülendiğinde görünümünü denetleen bazı temel şablon davranışları sağlar. Bkz. DGML dosyalarını düzenleyerek kod eşlemelerini özelleştirme.

    Örnek:

    <?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="http://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node Id="Driver" Label="Driver" Category="Person" />
      <Node Id="Car" Label="Car" Category="Automobile" />
      <Node Id="Truck" Label="Truck" Category="Automobile" />
      <Node Id="Passenger" Category="Person" />
   </Nodes>
   <Links>
      <Link Source="Driver" Target="Car" Label="Passed" Category="PassedTest" />
      <Link Source="Driver" Target="Truck" Label="Failed" Category="FailedTest" />
   </Links>
   <Categories>
      <Category Id="Person" Background="Orange" />
      <Category Id="Automobile" Background="Yellow"/>
      <Category Id="PassedTest" Label="Passed" Stroke="Black" Background="Green" />
      <Category Id="FailedTest" Label="Failed" BasedOn="PassedTest" Background="Red" />
   </Categories>
</DirectedGraph>

  • <Properties></Properties>

    Bu öğe, öğelerin listesini <Property/> içerir. Daha fazla bilgi için öğesine bakın <Property/> .

    Örnek:

    <?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="http://schemas.microsoft.com/vs/2009/dgml">
   <Properties>
       <Property ... />
   </Properties>
</DirectedGraph>

  • <Property/>

    Bu öğe, kategoriler ve diğer özellikler de dahil olmak üzere herhangi bir Property DGML öğesine veya özniteliğine değer atamak için kullanabileceğiniz bir özniteliği tanımlar.

    Bu öğenin öznitelikleri şunlardır:

    • Id- Ayrı bir Label öznitelik belirtilmezse özelliğin benzersiz adı ve özniteliğin Label varsayılan değeri.

    • DataType - Özelliği tarafından depolanan veri türü

      Özelliğin Özellikler penceresinde görünmesini istiyorsanız özelliği kullanarak Label özelliğin görünen adını belirtin.

      Bkz. Kod öğelerine ve bağlantılara kategori atama.

      Örnek:

    <?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="http://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node Id="Driver" Label="Driver" Category="Person" DrivingAge="18"/>
      <Node Id="Car" Label="Car" Category="Automobile" />
      <Node Id="Truck" Label="Truck" Category="Automobile" />
      <Node Id="Passenger" Category="Person" />
   </Nodes>
   <Links>
      <Link Source="Driver" Target="Car" Label="Passed" Category="PassedTest" />
      <Link Source="Driver" Target="Truck" Label="Failed" Category="FailedTest" />
   </Links>
   <Categories>
      <Category Id="Person" Background="Orange" />
      <Category Id="Automobile" Background="Yellow"/>
      <Category Id="PassedTest" Label="Passed" Stroke="Black" Background="Green" />
      <Category Id="FailedTest" Label="Failed" BasedOn="PassedTest" Background="Red" />
   </Categories>
   <Properties>
       <Property Id="DrivingAge" Label="Driving Age" DataType="System.Int32" />
   </Properties>
</DirectedGraph>

Yaygın olarak kullanılan yollar için diğer adlar

Yaygın olarak kullanılan yolların takma adlarla değiştirilmesi .dgml dosyasının boyutunu azaltır ve dosyayı yüklemek veya kaydetmek için gereken süreyi kısaltır. Diğer ad oluşturmak için .dgml dosyasının sonuna bir <Paths></Paths> bölüm ekleyin. Bu bölümde, yol için bir <Path/> diğer ad tanımlamak üzere bir öğe ekleyin:

<Paths>
   <Path Id="MyPathAlias" Value="C:\...\..." />
</Paths>

.dgml dosyasındaki Id<bir öğenin diğer adına başvurmak için Path/> öğesini dolar işareti ($) ve parantez (()) içine alın:

<Nodes>
   <Node Id="MyNode" Reference="$(MyPathAlias)MyDocument.txt" />
</Nodes>
<Properties>
   <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" />
</Properties>

Ayrıca bkz.