Aracılığıyla paylaş

Tüm FORM XML öğeleri başvurusu

  • Makale

Tüm öğeleri ve iş öğesi türü için formu denetleyen ana öznitelikleri için hızlı başvuru olarak, bu konudaki bilgiler kullanabilirsiniz.Bu öğeleri belirtin FORM öğe kapsayıcı, üçüncü ve son ana bölümünü iş öğesi türü tanımı.Birçok öğeleri başkalarının içinde form grupları, bölümler veya bir iş öğesi formunda sekme yerleştirilir.Bu öğelerden gruplandırmak hakkında daha fazla bilgi için bkz: İş öğesi formunu tasarlama.

Bu konuda

  • FORM Örneği

  • FORM öğeleri için sözdizimi

  • FORM öğelerini belirten öznitelikleri

  • Tek başına etiketleri, köprüler, Web sayfaları veya HTML içeriği belirtin öğeleri

  • Filtre ve bağlantı ilişkilerini görüntüleyen öğeleri

FORM Örneği

Aşağıdaki örnek, genel yapısını gösterir FORM öğesi.Kullanarak bir form yerleşimini belirten Layout öğesi.Farklı istemcileri hedef farklı düzenleri belirtebilirsiniz.Örneğin, Windows istemcileri ve için farklı bir düzen için bir düzen belirtebilirsiniz Team Web Access.Bir düzen, genellikle formun üst ve ardından sekme grubunu oluşur.Düzen içinde öğeleri tanımladığınız sıralamadaki öğeleri formda görünme sırasını belirler.

Öğe içinde sütunlar kullanarak görünür grup Group ve Column öğeleri.Kullandığınız bir Control öğenin formda görünmesini istediğiniz her bir alan tanımlayın.Kullandığınız Tab alan gruplarının farklı işlevsel alanına desteklemek için öğesi.

<FORM>
      <Layout>
        <Group>
          <Column PercentWidth="70">
            <Group>
              <Column PercentWidth="100">
                <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
                <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />
                <Control FieldName="System.IterationPath" Type="WorkItemClassificationControl" Label="&amp;Iteration Path:" LabelPosition="Left" />
                <Group>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.ProductUnit" Type="FieldControl" Label="PU (Use Area Path)" LabelPosition="Left" />
                  </Column>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.Priority" Type="FieldControl" Label="Priority" LabelPosition="Left" />
                  </Column>
                </Group>
              </Column>
            </Group>
          </Column>
          <Column PercentWidth="30">
            <Group Label="Status">
              <Column PercentWidth="100">
                <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
                <Control FieldName="System.State" Type="FieldControl" Label="State" LabelPosition="Left" />
                <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assigned To" LabelPosition="Left" />
              </Column>
            </Group>
          </Column>
        </Group>

. . .
</Layout>
</FORM>

Form öğelerini

Bilgi ve iş öğesi alanları nasıl gruplandırılır belirtin ve aşağıdaki tabloda açıklanan öğeleri kullanarak bir iş öğesi formu görüntülenir.

[!NOT]

En iyi sonucu almak için iç içe Control öğelerin bir Group, ve iç içe Group öğelerin bir Column, bile form tam genişliğini sütun yayar.Ayrıca, iç içe herColumn计划 bir Group, hiçbir görünür etiket ya da sınırı olsa bile grubu.

Öğe

Açıklama

Gerekli midir?

Column

Formun bölgelerini sütunlara böler.

<Column PercentWidth="WidthPerceOfContainingElement" FixedWidth="WidthInPixels">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Column >

Önerilen

Control

Bir alan, metin, köprü veya diğer denetim öğesi iş öğesi formunda görünmesini tanımlar.

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Padding="(top, bottom, left, right)" 
Margin="( top, bottom, left, right)" ReadOnly="True | False" MinimumSize="(Width,Height)" 
Name="InstanceName" />

Daha fazla bilgi için bkz. Denetim XML öğesi başvurusu.

Gerekli

FORM

Üst düzey form öğesi tanımlar.

<FORM>
   <Layout> . . . </Layout>
</FORM>

Gerekli

Group

Windows grup için benzer öğelerin görsel bir gruplandırma sağlar.

<Group Label="LabelText" Padding="(top, bottom, left, right)" Margin="(top, bottom, left, right)">
   <Column> . . . </Column>
</Group >

Önerilen

Layout

İş öğesi formu düzenini tanımlar.

<Layout Target="ClientName" MinimumSize="(width,height)" Padding="(top, bottom, left, right)" 
Margin="(left, top, right, bottom)" ControlSpacing="Distance" LabelSpacing="Distance">
   <Group> . . . </Group>
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Layout>

Gerekli

Splitter

Bir form iki eş form öğesi düzenini desteklemek üzere iki alana böler.

Splitter />

İsteğe Bağlı

Tab

Tek bir sekme düzenini sekme grubunda tanımlar.

<Tab Label="LabelText" Padding="(top, bottom, left, right)" Margin="(top, bottom, left, right)">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Tab>

İsteğe Bağlı

TabGroup

Form için bir veya daha fazla sekme tanımlar.

<TabGroup Padding="( top, bottom, left, right)" Margin="(top, bottom, left, right)">
   <Tab> . . . </Tab>
</TabGroup>

İsteğe Bağlı

FORM öğelerini biçimlendirmek için kullanılan öznitelikleri

Aşağıdaki tabloda açıklanan öznitelikleri belirterek aralık ve bir iş öğesi formundaki birçok öğelerinin boyutunu kontrol edebilirsiniz.Daha fazla bilgi için bkz. İş öğesi formunu tasarlama.

Öznitelik

Açıklama

Uygulanabilir öğeler

ControlSpacing

İsteğe bağlı.Dikey uzaklık denetimlerinin belirtir.Tamsayı.

Layout

FixedWidth

İsteğe bağlı.Piksel cinsinden sütun genişliği.PercentWidthve FixedWidth karşılıklı olarak birbirini dışlar.

Column

Label

İsteğe bağlı.Bir denetim veya grup için görüntülenecek metin.Bir etiket belirtilirse, denetim için meta veri alanı ile ilişkili herhangi bir etiket geçersiz kılar.

İçin gerekli Tab öğesi.Sekme için görüntülenecek metin.

LabelText 1 ila 80 karakter içeren metin dizesi.

Control

Group

Tab

LabelPosition

İsteğe bağlı.Alan verilere göre etiket konumu.Olası değerler üst ve alt, sol ve sağ olur.

Control

LabelSpacing

İsteğe bağlı.Etiket düzenleme bölge denetimin arasındaki piksel sayısını belirtir.

Layout

Margin

İsteğe bağlı.Denetimin çevresindeki ve Denetim ile komşu arasındaki boşluk miktarını piksel cinsinden belirten biçim dizesi (sol, üst, sağ, alt).Her iki yanına alan miktarı değişebilir.

Desen değeri: ^ \(\d+\,\d+\,\d+\,\d+\)$

Desen değeri örneği: (2,0,2,0)

Control

Group

Layout

Tab

TabGroup

MinimumSize

İsteğe bağlı.Biçim dizesi (genişliği, yükseklik).Bu değer form için en az boyutu belirtir.Kapsayıcı denetimi, bu boyuttan küçük yatay ve dikey kaydırma çubukları görüntülenir.

Control

Layout

Name

İsteğe bağlı.Denetim adı.Belirtilmezse, aynı addır FieldName.

Control

Padding

İsteğe bağlı.Denetimin dış sınırlarındaki ve iç yer miktarını piksel cinsinden belirtir (üst, alt sol, sağ,) biçim dizesi kenarlık.Her iki yanına alan miktarı değişebilir.

Control

Group

Layout

Tab

TabGroup

PercentWidth

İsteğe bağlı.Sütun genişliği içeren öğenin genişlik yüzdesi olarak.PercentWidthve FixedWidth karşılıklı olarak birbirini dışlar.

Column

ReadOnly

İsteğe bağlı.Denetim içinde bir salt okunur alan görüntüleyebilirsiniz.Bu öznitelik için farklı denetimleri biraz farklı şekillerde yanıt.

Control

Target

İsteğe bağlı.Bu düzen hangi istemciye uygular belirten dize.Visual Studiovarsa bu iş öğesi türü bu düzende görüntüler Target özniteliği atlanmış veya Windows Forms için ayarlayın.Dış istemcileri özel kullanarak ilave düzenler belirleyebilir Target özniteliklere Visual Studio yok sayar.

Şu değerler geçerlidir:

  • WinForms: Uygulanır forma Ekip Gezgini ve Takım Gezgini Her Yerde.

  • Web: Uygulanır forma Team Web Access.

Layout

Type

Gerekli.Denetim türü.Daha fazla bilgi için bkz. Denetim XML öğesi başvurusu.

Control

Tek başına etiketleri, köprüler, Web sayfaları veya HTML içeriği belirtin öğeleri

WebpageControlOptions Öğeyi ve alt öğeleri aşağıdaki sözdizimi yapısını sahip:

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >
   <Link UrlRoot="UrlRoot" UrlPath ="UrlPathWithParameters">
      <Param index="IndexValue" value="ParamValue" type ="Original | Current"/>
   </Link>
   <Content>
      <![CDATA[Contents of HTML]]>
   </Content>
</WebpageControlOptions>

Düz metin veya köprü etiketlerini tanımlamak, bir alan köprüleri ekleyin veya bir iş öğesi formunda Web sayfası içeriği görüntülemek için aşağıdaki tabloda açıklanan öğeleri kullandığınız.Daha fazla bilgi için bkz. İş öğesi formunda yardım metni, köprü veya web içeriği sağlama.

Öğe

Gerekli midir?

Açıklama

Content

İsteğe bağlı WebpageControlOptions öğesi.

Bir iş öğesi formunda görünecek CDATA HTML tabanlı içeriği belirtir.

<Content>
   <![CDATA[Contents of HTML]]>
</Content>

Daha fazla bilgi için bkz. WebpageControlOptions XML Öğeleri Başvurusu.

LabelText

İsteğe bağlı Control öğe olduğunda type="LabelControl".

Ya da bir düz veya köprü etiket tanımlar.

Daha fazla bilgi için bkz. LabelText ve Metin XML Öğeleri Başvurusu.

Link

İsteğe bağlı Control öğe olduğunda type="FieldControl".

İsteğe bağlı Text öğesi.

İsteğe bağlı WebpageControl öğesi.

İsteğe bağlı WebpageControlOptions öğesi.

Alan, etiket veya bir iş öğesi formunda görünmesini Web tarayıcı içeriği için köprü belirler.

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param />
</Link>

Daha fazla bilgi için bkz. Bağlantı ve Parametre XML Öğeleri Başvurusu.

Param

İsteğe bağlı Link öğesi.

Köprü URL'sini belirlemek için bir değer belirtir olduğunda URLPath için belirtilen Link öğesi.

<Param index="IndexValue " value="ParamValue " type ="Original | Current"/>

Daha fazla bilgi için bkz. Bağlantı ve Parametre XML Öğeleri Başvurusu.

Text

İsteğe bağlı LabelText öğesi.

Bilgi veya iş öğesi formunda görünmesini etiket için kapsayıcı öğe.

<Text>
   <Link >
      <Param />
   </Link>
   LabelText
</Text>

Daha fazla bilgi için bkz. LabelText ve Metin XML Öğeleri Başvurusu.

WebpageControlOptions

İsteğe bağlı Control öğe olduğundatype="WebpageControl"

Web sayfası denetimi yönelik seçenekleri belirten kapsayıcı öğe.

Daha fazla bilgi için bkz. WebpageControlOptions XML Öğeleri Başvurusu.

Filtre ve bağlantı ilişkilerini görüntüleyen öğeleri

Kullandığınız LinksControlOptions ne bağlantıları için bir iş öğesi ve bir iş öğesinde bağlantıların listesi için görüntülenmesini istediğiniz varsayılan sütunları eklenebileceğini denetlemek için seçenekleri tanımlamak için öğesi.Bir iş öğesi formuna bağlantı denetimi eklediğinizde, kullanıcılar oluşturabilir ve iş öğeleri arasında hangi kullanıcıların türlerini bağlantılar oluşturabilirsiniz bağlantı türlerini sınırlayan filtreler belirtebilirsiniz.LinksControlOptions Öğesini ve onun alt öğelerini aşağıdaki yapıya sahip:

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reverseName | forwardName" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeReferenceName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="referenceName" | LinkAttribute="linkAttributeName"/>
   </LinkColumns>
</LinksControlOptions>

Özellikle, aşağıdaki tabloda özetlenen öğeleri kullanır.Bu öğelerden kullanma hakkında daha fazla bilgi için bkz: Bağlantı ilişkilerini kısıtlamak için bağlantı denetimlerini tanımlama ve LinksControlOptions Öğeleri.

Öğe

Gerekli midir?

Açıklama

LinksControlOptions

İsteğe bağlı Control öğe olduğundatype="LinksControl"

Seçenekler hangi bağlantıları denetlemek için tanımlayan öğeleri için bir kapsayıcı bir iş öğesi ve bir iş öğesinde bağlantıların listesi için görüntülenmesini istediğiniz varsayılan sütunları eklenebilir sağlar.

WorkItemLinkFilters

İsteğe bağlı LinksControlOptions öğesi

Bir veya daha fazla bilgi için bir kapsayıcı sağlar Filter öğesi bağlantıyı belirten filtre ölçütü takım projesi koleksiyonu için tanımlanan bağlantı türleri için kullanılacak.

ExternalLinkFilters

İsteğe bağlı LinksControlOptions öğesi

Bir veya daha fazla bilgi için bir kapsayıcı sağlar Filter için kullanılacak filtre ölçütünü belirtir öğeleri bağlantı diğer takım projelerinde tanımlı türleri.

WorkItemTypeFilters

İsteğe bağlı LinksControlOptions öğesi

Bir veya daha fazla bilgi için bir kapsayıcı sağlar Filter öğeleri çalışma öğesi türleri uygulamak için filtre ölçütünü belirtir.

Filter(bağlantı türleri)

Gerekli WorkItemLinkFilters öğe olduğunda FilterType özniteliği exclude veya include.

Gerekli ExternalLinkFilters öğe olduğunda FilterType özniteliği exclude veya include.

Eklenecek veya iş öğesi için oluşturulan bağlantıları kümesinden bağlantı türlerini belirtir.

Filter(iş öğesi türleri)

İsteğe bağlı WorkItemTypeFilters öğe olduğunda FilterType özniteliği exclude veya include.

Eklenecek veya iş öğesi türü arasında hangi kullanıcıların bağlantısını kümeden hariç tut iş öğeleri türlerini belirtir.

LinkColumns

İsteğe bağlı LinksControlOptions öğesi

Bir veya daha fazla bilgi için bir kapsayıcı sağlar LinkColumn etiketler.

LinkColumn

Gerekli LinkColumns öğesi

İş öğesi alanları ve iş öğesi formunda bağlantıların listesi için görünmesini bağlantı türü özniteliklerini belirtir.

Ayrıca bkz.

Kavramlar

İş öğesi formunu tasarlama

Diğer Kaynaklar

İş öğesi izleme: XML öğe tanımları dizini