FindControl-Vorgang

 

Veröffentlicht: November 2016

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

In diesem Artikel werden die beiden Ansätze bechrieben, die verwendet werden können, um ein Benutzeroberflächen (UI)- Steuerelement zu identifizieren.

In diesem Thema

Strukturbasierte Identifizierung der Benutzeroberfläche

Offset-basierte Identifizierung

Strukturbasierte Identifizierung der Benutzeroberfläche

Diese Methode erfasst die vollständige Strukturdarstellung des Steuerelements. Es verwendet alle Steuerelementeigenschaften, um zum endgültigen Steuerelement durchzulaufen.

Folgendes ist ein Beispiel-Bindungsformat:

<UIElement Name="UISystemandSecurityHyperlink">
<UIObject MatchCount="1">                            
              <AndCondition>
                <PropertyCondition Name="Name">CPCategoryPanel</PropertyCondition>
                <PropertyCondition Name="ControlType">Pane</PropertyCondition>
              </AndCondition>
                <UIObject>                                   
                  <AndCondition>
                    <PropertyCondition Name="Name">System and Security</PropertyCondition>
                    <PropertyCondition Name="ControlType">Hyperlink</PropertyCondition>
                  </AndCondition>                  
                </UIObject>
            </UIObject>
<UIElement>

Die Tags werden wie folgt erklärt:

• <UIElement> – Dies ist der Stammknoten, der über das Name-Attribut verfügt:

  • -Name - Erfasst den Anzeigenamen, der im DDA verwendet wird.

  • -StartFromDesktop - Gibt an, ob die Suche vom Desktop oder vom übergeordneten Element ausgeht.

  • ParentUIElement – Gibt das UIElement an, das als übergeordnetes Steuerelement geschaltet werden muss. Für die Schaltflächen muss "Bereich" als ParentUIElement angegeben werden. Dies ist hilfreich, wenn Sie manuell eine Bindung erstellen.

  • -MatchCount - Gibt die Übereinstimmungsanzahl an. Wenn mehr als ein Steuerelement dieselben Eigenschaften hat, wird es auf Grundlage dieses Index identifiziert.

• <UIObject> - Dieser Knoten erfasst die vollständige Strukturdarstellung, um das Steuerelement zu identifizieren:

  • -<PropertyCondition Name="Name">CPCategoryPanel</PropertyCondition> - Erfasst die Eigenschaftsbedingung, nach der das Steuerelement gesucht wird. Dieser wird in AndCondition/OrCondition/NotCondition gruppiert. Wenn es nur eine PropertyCondition gibt, sollte es im Stammknoten ohne Gruppierung angezeigt werden.Name stellt den Namen der Steuerelementeigenschaft dar.

  • AndCondition und OrCondition- NotCondition - Gruppierungsbedingungen für die Eigenschaftsbedingung.

  • <AndCondition Id="SearchCondition"> – Erfasst die Eigenschaftsbedingung, mit der das Steuerelement identifiziert werden kann.Id stellt die Bedingungslisten-ID dar. Mehrere AndCondition können verwendet werden, wenn die Gruppierung später bereitgestellt wird.

  • <OrCondition Id="SearchCondition"> – Erfasst die Eigenschaftsbedingung, mit der das Steuerelement identifiziert werden kann.Id stellt die Bedingungslisten-ID dar. Mehrere OrCondition können verwendet werden, wenn die Gruppierung später bereitgestellt wird.

  • <NotCondition Id="SearchCondition"> – Erfasst die Eigenschaftsbedingung, mit der das Steuerelement identifiziert werden kann.Id stellt die Bedingungslisten-ID dar. Mehrere NotCondition können verwendet werden, wenn die Gruppierung später bereitgestellt wird.

  • AndCondition, NotCondition und OrCondition - Können geschachtelt werden, sollten aber korrekt gruppiert werden. Die obersten XML-Bindungen sollten nur eine Bedingung haben, und sie kann intern gruppiert werden.

Offset-basierte Identifizierung

Diese Methode ist sehr einfach zu verwenden und baut auch die Bindungen auf.

Hinweis

Diese Methode kann nicht verwendet werden, wenn der Strukturort des Steuerelements sich ändert, da er die Positionszahl in der Benutzeroberflächen-Struktur verwendrt ,um die Steuerelemente zu ermitteln. Wenn die Benutzeroberflächen-Strukturposition dynamisch geändert wird, ist dieser Methode nicht verwendbar.

MatchCount-Attribut wird als Offsetebene verwendet. Bedingungen werden bei Bedarf verfügbar gemacht.

Folgendes ist ein Beispiel-Bindungsformat.

<UIElement name="textBoxTabPage1">
          <UIObject MatchCount="2">            
            <UIObject  MatchCount="1">             
              <UIObject   MatchCount="2">                
              </UIObject>
            </UIObject>
          </UIObject>
        </UIElement>

Siehe auch

UIADDA
Verwenden von datengesteuerten Adaptern (DDAs)

Unified Service Desk 2.0

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright