Element formantu XML — Odwołanie

Artykuł
06/09/2015

Możesz użyć Control elementu do definiowania utwór elementu pola, tekst, hiperłącze lub innego elementu sterowania do wyświetlenia w postaci elementów roboczych.Przykłady sposobów użycia tego elementu, zobacz Określanie sterowania formularzem elementu pracy.Aby uzyskać więcej informacji, zobacz Projektowanie i dostosowywanie formularza elementu roboczego [redirected].

Schemat hierarchii

<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"  Padding="(top, bottom, left, right)"  Margin="(top, bottom, left, right)" ReadOnly="True | False" MinimumSize="(width,height)"  Name="InstanceName" > <LabelText> . . . </LabelText> <Link> . . . </Link> <LinksControlOptions> . . . </LinksControlOptions> <WebpageControlOptions> . . . </WebpageControlOptions> </Control>

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	Opis
FieldName	Opcjonalny atrybut typu Control. Określa pole elementu pracy, z którą jest skojarzone kontrolki.Typ atrybutu typelib:ReferenceFieldName.Minimalna długość: 1; Maksymalna długość: 70. Wartość do wzorca: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [a-zA-Z0-9_] +) + $ Wzorzec wartość przykład: Company.Division.IssueType
Type	Wymagany atrybut typu Control. Określa typ danych kontrolki.Typ atrybutu ValidControlsType typu prostego.Określ ciąg z jednego z następujących typów wbudowane: AttachmentControl: Służy do wyświetlania załączników elementu pracy.Ten formant nie ma skojarzonego pola lub typu pola. DateTimeControl: Służy do wyświetlania daty sformatowane pól z typem pola DateTime. FieldControl: Służy do wyświetlania zwykły pól tekstowych czy liczbowych i wyświetla wartości w przypadku pól z typem pola String, Identity, Integer, Double, i PlainText. HtmlFieldControl: Służy do wyświetlania wielowierszowego, tekstu sformatowanego formatu pól z typem pola HTML. LabelControl: Służy do wyświetlania tekstu, który nie jest skojarzony z polem.Tekst może być zwykły lub hiperłącze.Możesz określić dodatkowe formanty za pomocą LabelText, Link i Text elementów.Zobacz LabelText i odnośniki do elementów tekstowych XML i Elementy XML Link and Param — Odwołanie. LinksControl: Służy do wyświetlania narzędzi kontroli łącza i zarządzanie relacjami łącze między elementów roboczych i scenorysy.Ten formant nie ma skojarzonego pola lub typu pola.Określ typy łączy do filtru i inne opcje kontroli za pomocą LinksControlOptions elementu.Zobacz Elementy LinksControlOptions. WebpageControl: Służy do wyświetlania zawartości HTML zdefiniowane za pomocą identyfikatora URI lub osadzone w tagu CDATA.Ten formant nie ma skojarzonego pola lub typu pola..Określ zawartość i łącza do wyświetlenia przy użyciu WebpageControlOptions elementu.Zobacz WebpageControlOptions Elementy XML — Odwołanie. WorkItemClassificationControlSłuży do wyświetlania pól hierarchiczne ścieżki z typem pola TreePath. [!UWAGA] System.AreaPath i System.IterationPath pola są tylko pola, które używają tego typu danych.Nie można zdefiniować pola niestandardowe przy użyciu tego typu danych. WorkItemLogControl: Służy do wyświetlania informacji o historii elementu pracy i pola z typem pola History. [!UWAGA] System.History Pole jest tylko pole, które używa tego typu danych.Nie można zdefiniować pola niestandardowe przy użyciu tego typu danych. Aby uzyskać więcej informacji, zobacz Określanie sterowania formularzem elementu pracy. [!UWAGA] Używasz niestandardowego formantu przez ustawienie Type atrybutów niestandardowych wartości.Dowolne kontrolować, którego Type wartość jest niezgodna z nazwą wbudowany typ jest traktowany jako formant niestandardowy.Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: formanty niestandardowe śledzenia elementów roboczych.
ControlFontSize	Opcjonalny atrybut typu Control. Określa rozmiar czcionki, nazwy pola lub etykiety w formularzu.Valid values of FontSize: small, normal, large, xlarge, and xxlarge.
EmptyText	Opcjonalny atrybut typu Control. Określa ciąg tekstowy od 1 do 255 znaków wyświetlanego, gdy pole jest puste.
Label	Opcjonalny atrybut typu Control. Określa tekst wyświetlany w formularzu, który identyfikuje formant.Określ ciąg składający się z nie więcej niż 80 znaków.
LabelFontSize	Określa rozmiar czcionki etykiety w formularzu.Valid values for FontSize: small, normal, large, xlarge, and xxlarge.
LabelPosition	Opcjonalny atrybut typu Control. Określa położenie etykiety względem danych kontrolki.Określ ciąg z jednej z następujących wartości: Top: Powoduje umieszczenie etykiety powyżej danych kontrolki. Bottom: Powoduje umieszczenie etykiety poniżej danych kontrolki. Left: Powoduje umieszczenie etykiety po lewej danych kontrolki. Right: Powoduje umieszczenie etykiety po prawej stronie formantu danych.
Padding	Opcjonalny atrybut typu Control. Określa ilość miejsca w pikselach wokół wewnątrz obramowania formantu, który odpowiada i u góry, u dołu, po lewej, spacje po prawej.Typ atrybutu SizeType. Wartość do wzorca: ^ $\d+\,\d+\,\d+\,\d+$$ Przykład wartość wzorzec: (2,0,2,0)
Margin	Opcjonalny atrybut typu Control. Określa ilość miejsca w pikselach wokół zewnętrznego obramowania formantu, który odpowiada i u góry, u dołu, po lewej, spacje po prawej.Typ atrybutu SizeType. Wartość do wzorca: ^ $\d+\,\d+\,\d+\,\d+$$ Przykład wartość wzorzec: (2,0,2,0)
ReadOnly	Opcjonalny atrybut typu Control. Określa, że jest to pole tylko do odczytu.Typ atrybutu ReadOnlyType.Określ ciąg z jednej z następujących wartości: True: Określa, czy dane kontroli jest tylko do odczytu. False: Określa, że dane kontroli nie jest tylko do odczytu.
MinimumSize	Opcjonalny atrybut typu Control. Określa minimalny rozmiar w pikselach, którą kontrolki powinna zajmować w formularzu.Składnia jest określone w (width,height).Typ atrybutu SizeType. Wartość do wzorca: ^ $\d+\,\d+$$ Przykład wartość wzorzec: (100,100) [!UWAGA] Jeśli użytkownik nie ma wystarczającej ilości miejsca w pionie, paska przewijania pojawia się do zachowania jej minimalnego rozmiaru.Bez tego atrybutu formantów są rysowane z ich rozmiary domyślne, chyba że kontrolek w inne karty wykonać więcej miejsca.Całkowity rozmiar dowolnego formantu jednego formularza zależy od rozmiaru największego obszaru formularza lub karty.
Name	Opcjonalny atrybut typu Control. Unikatowo identyfikuje formantu.Name Jest ważna, jeśli więcej niż jeden formant na formularzu jest skojarzony z tego samego pola elementu pracy.Typ atrybutu xs:string. [!UWAGA] Możesz użyć Name atrybutu, gdy użytkownik chce mieć to samo pole wyświetlane w więcej niż jednej lokalizacji w formularzu.Określasz unikatową wartość dla atrybutu Name dla obu wpisów kontroli, tak aby system jednoznacznie identyfikował każdy formant.Warto pokazać ten sam formant w różnych miejscach na podstawie kontekstu kart.
NumberFormat	Opcjonalny Control atrybut, który jest prawidłowa tylko wtedy, gdy jest używany z FieldControl. Określa znaki, które można wprowadzać w formancie pola.Prawidłowe wartości, które są dostępne są następujące: WholeNumbers: Określa, czy są dozwolone liczb całkowitych. SignedWholeNumbers: Określa, czy dozwolone są podpisane liczb całkowitych. DecimalNumbers: Określa, czy dozwolone są cyfry dziesiętne. SignedDecimalNumbers: Określa, czy podpisany cyfry dziesiętne są dozwolone.
MaxLength	Opcjonalny Control atrybut, który jest prawidłowa tylko wtedy, gdy jest używany z FieldControl. Określa maksymalną długość znaków dozwolonych dla formantu pola.Typ atrybutu xs:integer.
Format	Opcjonalny Control atrybut, który jest prawidłowa tylko wtedy, gdy jest używany z DateTimeControl. Określa format dla pola daty i godziny odpowiadające jedna z wartości wyliczenia DateTimePickerFormat.Prawidłowe wartości, które są dostępne są następujące: Custom: Wyświetla wartość daty/godziny w niestandardowym formacie.Format niestandardowy można ustawić przez określenie "Custom" jako wartość dla atrybutu Format i ustawienie innego atrybutu o nazwie CustomFormat z niestandardowy ciąg formatu.Na przykład: Format = "Niestandardowe" CustomFormat = "Mm-dd, rrrr"roku"" Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: właściwości DateTimePicker.CustomFormat. Long: Wyświetla wartość daty/godziny w formacie daty długiej ustawione przez użytkownika systemu operacyjnego. Short: Wyświetla wartość daty/godziny w formacie daty krótkiej ustawione przez użytkownika systemu operacyjnego. Time: Wyświetla wartość daty/godziny w formacie godziny, ustawione przez użytkownika systemu operacyjnego. Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: wyliczenia DateTimePickerFormat.
CustomFormat	Opcjonalny Control atrybut, który jest prawidłowa tylko wtedy, gdy jest używany z DateTimeControl i Format atrybutu. Określa format niestandardowy dla pola daty i godziny odpowiadające składni zdefiniowane dla właściwości DateTimePicker.CustomFormat.Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: właściwości DateTimePicker.CustomFormat.

Elementy podrzędne

Element	Opis
LabelText	Element opcjonalny.Można określić tego elementu po Type nie jest określony jako FieldControl lub LabelControl. Element kontenera dla określenia tekstu, hiperłącza i położenie pola lub etykiety, którego tekst znajduje się częściowo skojarzony z hiperłączem. Aby uzyskać więcej informacji, zobacz LabelText i odnośniki do elementów tekstowych XML i Dodawanie tekstów pomocy, hiperłączy lub zawartości WWW do formularza elementów pracy.
Łącze	Element opcjonalny.Można określić tego elementu po Type nie jest określony jako FieldControl lub LabelControl. Definiuje hiperłącza dla pola lub etykiety. Aby uzyskać więcej informacji, zobacz Elementy XML Link and Param — Odwołanie i Dodawanie tekstów pomocy, hiperłączy lub zawartości WWW do formularza elementów pracy.
LinksControlOptions	Element opcjonalny.Można określić tego elementu po Type nie jest określony jako LinksControl. Definiuje filtry łącza i układu pól kolumny do wyświetlenia listy łączy. Aby uzyskać więcej informacji, zobacz Zmiana sterowania łączami w taki sposób, aby ograniczyć relacje pomiędzy nimi.
WebpageControlOptions	Element opcjonalny.Można określić tego elementu po Type atrybut jest WebpageControl. Określa formanty, które ma zastosowanie w przypadku ładowania docelowej strony sieci Web w postaci elementów roboczych. Aby uzyskać więcej informacji, zobacz WebpageControlOptions Elementy XML — Odwołanie i Dodawanie tekstów pomocy, hiperłączy lub zawartości WWW do formularza elementów pracy.
anyAttribute	Element opcjonalny. Parametr opcjonalny.Controljest rozszerzalny, korzystając ze anyAttribute elementu.

Elementy nadrzędne

Element	Opis
Układ	Parametr wymagany.Określa sposób wyświetlania elementów w formularzu elementu pracy.
Kolumna elementu	Parametr wymagany.Definiuje kolumny formularza.
Karta elementu	Parametr wymagany.Definiuje kartę formularza.

Uwagi

Controljest elementem opcjonalne podrzędny Layout, Column, i Tab.

Layouti Column wskaźniki:

minOccurs = "0"

maxOccurs = "1"

Tabwskaźniki:

minOccurs = "0"

maxOccurs = "niepowiązanego"

Do zaimplementowania formant niestandardowy, należy określić nazwę formantu dla Type atrybutu.Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: formanty niestandardowe śledzenia elementów roboczych.

Na przykład poszczególne typy kontroli zobacz Określanie sterowania formularzem elementu pracy.

Przykład

<Control Type=" WorkItemClassificationControl " FieldName="System.AreaPath"
  Label="Area" LabelPosition="Left" Padding="(2,0,2,0)" Margin="(2,2,2,2)" />

Informacje o elementach

Przestrzeń nazw	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/TypeDef
Nazwa schematu	Definicja typu elementu roboczego
Sprawdzanie poprawności plików	WorkItemTypeDefinition.xsd
Typ elementu	Typ ControlType złożonych
Może być pusta.	Nie dotyczy