Denetim XML Öğesi Başvurusu

Makale
02/26/2013

Control öğesini iş öğesi alanı, metin, köprü veya diğer denetim öğesi tanımlayıp bir iş öğesi formunda görüntülemek üzere kullanırsınız.Bu öğenin nasıl kullanılacağına ilişkin örnekler için bkz. Çalışma Öğesi Form Denetimlerini Belirtme.Daha fazla bilgi için bkz. Çalışma Öğesi Formu Tasarlama ve Özelleştirme.

Şema Hiyerarşisi

<xs:element name="Control" type="ControlType" minOccurs="0"/>

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" ControlFontSize="FontSize" EmptyText="TextString"
Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ReadOnly="True | False" MinimumSize="(width,height)" 
Name="InstanceName" >
<LabelText> . . . </LabelText>
<Link> . . . </Link>
<LinksControlOptions> . . . </LinksControlOptions>
<WebpageControlOptions> . . . </WebpageControlOptions>
</Control>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik	Description
FieldName	İsteğe bağlı Control özniteliği. Denetimin ilişkilendirildiği iş öğesi alanını belirler.Öznitelik türü typelib:ReferenceFieldName'dir.En az uzunluk: 1; en fazla uzunluk: 70. Desen değeri: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Desen değeri örneği: Company.Division.IssueType
Type	Gerekli Control özniteliği. Denetimin veri türünü belirler.Öznitelik türü ValidControlsType Basit Türüdür.Aşağıdaki yerleşik değerlerden birinden bir dize belirler. AttachmentControl: İş öğesi eklerini görüntülemek için kullanınız.Bu denetim ilişkilendirilmiş bir alana veya alan türüne sahip değildir. DateTimeControl: Alan türü DateTime olan biçimlendirilmiş veri alanlarını görüntülemek için kullanınız. FieldControl: Alan türü StringIdentityIntegerDouble ve PlainText olan alanlar için düz metinli veya sayısal alanları ve değer listelerini görüntülemek için kullanınız. HtmlFieldControl: Alan türü HTML olan çok satırlı, zegin metin biçimli alanları görüntülemekte kullanınız. LabelControl: Bir alanla ilişkilendirilmemiş metinleri görüntülemekte kullanınız.Metin, düz veya köprülenmiş olabilir. Ek denetimleri kullanarak belirttiğiniz LabelText, Link ve Text öğeleri.Bkz. LabelText ve Metin XML Öğeleri Başvurusu ve Bağlantı ve Parametre XML Öğeleri Başvurusu. LinksControl: Bağlantılar Denetim araç çubuğunu görüntüleme ve çalışma öğeleri ve şeritleri arasındaki bağlantıyı ilişkileri yönetmek için kullanın.Bu denetim ilişkilendirilmiş bir alana veya alan türüne sahip değildir.Filtre ve diğer denetim seçenekleri kullanarak bağlantı türlerini belirtmek LinksControlOptions öğesi.Bkz: LinksControlOptions Öğeleri WebpageControl: CDATA etiketi içerisine gömülü veya bir URI tarafından tanımlı HTML temelli içeriği görüntülemekte kullanınız.Bu denetim ilişkilendirilmiş bir alana veya alan türüne sahip değildir..İçerik ve bağlantıları kullanarak görüntülemek için belirttiğiniz WebpageControlOptions öğesi.Bkz: WebpageControlOptions XML Öğeleri Başvurusu WorkItemClassificationControl: Alan türü TreePath olan hiyerarşik yol alanlarını görüntülemek için kullanınız. Not Yalnız System.AreaPath ve System.IterationPath alanları bu veri türünü kullanır.Bu veri türünü kullanarak özel bir alan tanımlayamazsınız. WorkItemLogControl: Alan türü History olan alanları ve iş öğesi geçmiş bilgisini görüntülemekte kullanınız. Not Yalnız System.History alanı bu veri türünü kullanır.Bu veri türünü kullanarak özel bir alan tanımlayamazsınız. Daha fazla bilgi için bkz. Çalışma Öğesi Form Denetimlerini Belirtme. Not Type özniteliğini özel bir değere ayarlayarak özel bir denetim kullanabilirsiniz. Type değeri yerleşik bir tür ismiyle eşleşmeyen denetimler özel denetim olarak nitelendirilir.Daha fazla bilgi için bkz. Microsoft Web sitesi: İş Öğesi İzleme Özel Denetimleri.
ControlFontSize	İsteğe bağlı Control özniteliği. Formda alan adını veya etiketi yazı tipi boyutunu belirtir.Valid values of FontSize: small, normal, large, xlarge, and xxlarge.
EmptyText	İsteğe bağlı Control özniteliği. Alan boş olduğunda görüntülenen uzunluğu 1 ile 255 karakter arasında bir metin dizesini belirtir.
Label	İsteğe bağlı Control özniteliği. Denetimi tanımlayan formun üzerindeki görünür metini belirler. En fazla 80 karakter içeren dize belirler.
LabelFontSize	Formda etiketi yazı tipi boyutunu belirtir.Valid values for FontSize: small, normal, large, xlarge, and xxlarge.
LabelPosition	İsteğe bağlı Control özniteliği. Denetim verileriyle alakalı olan etiketlerin pozisyonlarını belirler. Aşağıdaki değerlerden birinden dize belirler. Top: Denetim verisinin üstüne etiketi yerleştirir. Bottom: Denetim verisinin altına etiketi yerleştirir. Left: Denetim verisinin soluna etiketi yerleştirir. Right: Denetim verisinin sağına etiketi yerleştirir.
Dock	İsteğe bağlı Control özniteliği. Kapsayıcının belirlenen tarafı ile alanı hizalar veya kapsayıcıyı doldurmak için alanı genişletir.Öznitelik türü DockType'dir.Aşağıdaki değerlerden birinden dize belirler. Fill: Kapsayıcıyı doldurması için alanı hizalar.Bu değer Splitter Öğesi için desteklenen bir hizalama değildir. Top: Kapsayıcının üst tarafını alan ile beraber hizalar.Bu değer Splitter Öğesi için desteklenen bir hizalama değildir. Bottom: Kapsayıcının alt tarafını alan ile beraber hizalar.Bu değer Splitter Öğesi için desteklenen bir hizalama değildir. Left: Kapsayıcının sol tarafını alan ile beraber hizalar. Right: Kapsayıcının sağ tarafını alan ile beraber hizalar.Bu değer Splitter Öğesi için desteklenen bir hizalama değildir.
Padding	İsteğe bağlı Control özniteliği. Üst, alt, sol ve sağ taraflara karşılık gelen denetimin iç kenarlıkları civarındaki yer miktarını piksel cinsinden belirler.Öznitelik türü SizeType'dir. Desen değeri: ^$\d+\,\d+\,\d+\,\d+$$ Desen değeri örneği: (2,0,2,0)
Margin	İsteğe bağlı Control özniteliği. Üst, alt, sol ve sağ taraflara karşılık gelen denetimin dış kenarlıkları civarındaki yer miktarını piksel cinsinden belirler.Öznitelik türü SizeType'dir. Desen değeri: ^$\d+\,\d+\,\d+\,\d+$$ Desen değeri örneği: (2,0,2,0)
ReadOnly	İsteğe bağlı Control özniteliği. Alanın salt okunur olduğunu belirler. Öznitelik türü ReadOnlyType'dir.Aşağıdaki değerlerden birinden dize belirler. True: Denetim verisinin salt okunur olduğunu belirler. False: Denetim verisinin salt okunur olmadığını belirler.
MinimumSize	İsteğe bağlı Control özniteliği. Denetimin form üzerinde kaplayacağı minimum alan miktarını piksel cinsinden belirler.Sözdizimi (width,height) 'de belirtilmiştir.Öznitelik türü SizeType'dir. Desen değeri: ^$\d+\,\d+$$ Desen değeri örneği: (100,100) Not Yeterli dikey aralığa sahip değilseniz en küçük boyutunu korumak için bir kaydırma çubuğu belirir.Bu öznitelik olmadığında diğer sekmelerdeki denetimler daha fazla alan tutmadıkça denetimler varsayılan boyutlarına çekilir.Herhangi bir form denetiminin genel boyutu en büyük form alanı veya sekmesinin boyutuna bağlıdır.
Name	İsteğe bağlı Control özniteliği. Bir denetimi özgün şekilde tanımlar. Name özniteliği, form üzerindeki birden fazla denetim aynı çalışma öğesi alanıyla ilişkilendirilirse önemli hale gelir.. Öznitelik türü xs:string'dir. Not Name özniteliğini, aynı alanı form üzerindeki birden fazla yerde görüntülemek istiyorsanız kullanırsınız.Sistemin, her denetimi ayrı tanımlamasının sağlandığı girişleri denetlemek üzere Name niteliği için benzersiz bir değer belirtebilirsiniz.Aynı denetimi sekme bağlamındaki değişik bölgelerde göstermek işe faydalı olur.
NumberFormat	Seçeneğe bağlı Control özniteliği yalnızca FieldControl ile birlikte kullanıldığında geçerlidir. Alan denetiminde girdiğiniz karakterleri belirler.Kullanabileceğiniz geçerli değerler aşağıdaki gibidir. WholeNumbers: Bütün sayılara izin verildiğini belirler. SignedWholeNumbers: Bütün işaretli sayılara izin verildiğini belirtir. DecimalNumbers: Ondalık sayılara izin verildiğini belirtir. SignedDecimalNumbers: İşaretli ondalık sayılara izin verildiğini belirtir.
MaxLength	Seçeneğe bağlı Control özniteliği yalnızca FieldControl ile birlikte kullanıldığında geçerlidir. Alan kontrolü için izin verilen maksimum karakter sayısını belirler.Öznitelik türü xs:integer'dir.
Format	Seçeneğe bağlı Control özniteliği yalnızca DateTimeControl ile birlikte kullanıldığında geçerlidir. TarihSaatSeçimBiçimi değerlerinden birine karşılık gelen tarih-saat biçimini belirler.Kullanabileceğiniz geçerli değerler aşağıdaki gibidir. Custom: Tarih/zaman değerini özel bir biçimde görüntüler.Özel biçim, Biçimlendir özniteliğini 'Custom' olarak belirtmekle ve CustomFormat isimli başka bir özniteliği özel biçim dizesine ayarlamakla oluşturulabilir.Örne?in: Format="Custom" CustomFormat = "MMM dd, 'of the year' yyyy " Daha fazla bilgi için bkz. Microsoft Web sitesi: DateTimePicker.CustomFormat Özelliği. Long: Kullanıcının işletim sistemi tarafından ayarlanmış olan uzun tarih biçimindeki tarih/zaman değerini görüntüler. Short: Kullanıcının işletim sistemi tarafından ayarlanmış olan kısa tarih biçimindeki tarih/zaman değerini görüntüler. Time: Kullanıcının işletim sistemi tarafından ayarlanmış olan zaman biçimindeki tarih/zaman değerini görüntüler. Daha fazla bilgi için bkz. Microsoft Web sitesi: DateTimePickerFormat Numaralandırma.
CustomFormat	Seçeneğe bağlı Control özniteliği yalnızca DateTimeControl ve Format öznitelikleri ile birlikte kullanıldığında geçerlidir. DateTimePicker.CustomFormat özelliği için tanımlanan söz dizimine karşılık gelen tarih-saat alanı için kullanılan özel biçimi belirler. Daha fazla bilgi için bkz. Microsoft Web sitesi: DateTimePicker.CustomFormat Özelliği.

Alt Öğeler

Öge	Description
LabelText	İsteğe bağlı öğe.Bu öğe belirtebilirsiniz, Type özniteliği olarak belirtilen FieldControl veya LabelControl. Kapsayıcı öğe, metin ve alan pozisyonu veya metni köprüyle ilişkilendirilmiş olan etiketi belirlemek içindir. Daha fazla bilgi için, bkz. LabelText ve Metin XML Öğeleri Başvurusu ve Çalışma Öğesi Formunda Yardım Metni, İşlem Kılavuzu, Web İçeriği ve Web Sayfalarına Bağlantılar Sağlama.
Bağlantı	İsteğe bağlı öğe.Bu öğe belirtebilirsiniz, Type özniteliği olarak belirtilen FieldControl veya LabelControl. Bir etiket veya alan için köprü belirler. Daha fazla bilgi için bkz. Bağlantı ve Parametre XML Öğeleri Başvurusu ve Çalışma Öğesi Formunda Yardım Metni, İşlem Kılavuzu, Web İçeriği ve Web Sayfalarına Bağlantılar Sağlama.
LinksControlOptions	İsteğe bağlı öğe.Bu öğe belirtebilirsiniz, Type özniteliği olarak belirtilen LinksControl. Bağlantı listeleri göstermek için sütun alanı yerleşimi ve bağlantı filtreleri tanımlar. Daha fazla bilgi için bkz. Bağlantı İlişkilerini Kısıtlamak için Bağlantı Denetimlerini Tanımlama.
WebpageControlOptions	İsteğe bağlı öğe.Bu öğe belirtebilirsiniz, Type özniteliği WebpageControl. İş öğesi formuna Web sayfası hedefi yüklemeyi yöenten denetimleri belirler. Daha fazla bilgi için bkz. WebpageControlOptions XML Öğeleri Başvurusu ve Çalışma Öğesi Formunda Yardım Metni, İşlem Kılavuzu, Web İçeriği ve Web Sayfalarına Bağlantılar Sağlama.
anyAttribute	İsteğe bağlı öğe. İsteğe Bağlı.Control, anyAttribute öğesinin kullanılmasıyla geliştirilebilir.

Üst Öğeler

Öge	Description
Düzen	Gerekli.İş öğesi formu üzerindeki öğelerin nasıl görüntüleneceğini tanımlar.
Sütun Öğesi	Gerekli.Form için sütunları tanımlar.
Sekme Öğesi	Gerekli.Form için bir sekme tanımlar.

Notlar

Control; Layout, Column ve Tab'nin seçeneğe bağlı bir alt öğesidir.

Layout ve Column göstergeleri:

minOccurs = "0"

maxOccurs = "1"

Tab göstergeler:

minOccurs = "0"

maxOccurs = "unbounded"

Özel bir kontrol yapmak için, Type niteliği için bir denetim ismi belirlemelisiniz.Daha fazla bilgi için bkz. Microsoft Web sitesi: İş Öğesi İzleme Özel Denetimleri.

Her bir denetim türünün örneği için, bkz: Çalışma Öğesi Form Denetimlerini Belirtme

Örnek

<Control Type=" WorkItemClassificationControl " FieldName="System.AreaPath"
  Label="Area" LabelPosition="Left" />

Öğe Bilgisi

Ad uzayı	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Şema Adı	İş Öğesi Türü Tanımı
Dosya Doğrulama	WorkItemTypeDefinition.xsd
Öğe türü	ControlType Karmaşık Tür
Boş olabilir	Yok