Porady: dodawanie formantu niestandardowego do ekranu technologii Silverlight

Artykuł
02/27/2013

Można dodawać formanty Silverlight do ekranu LightSwitch.Za pomocą kontrolek Silverlight, możesz wyświetlać lub zbierać informacje w sposób wykraczający poza możliwości wbudowanych kontrolek LightSwitch.

Możesz używać kontrolek, które są dołączone do środowiska uruchomieniowego Silverlight i Silverlight SDK.Możesz także użyć kontrolek utworzonych za pomocą szablonów projektu Silverlight, na przykład te, które są dostępne w środowisku Visual Studio 2010.Oba rodzaje formantów są nazywane formantami niestandardowymi w LightSwitch.

Aby uzyskać informacje na temat tworzenia kontrolek niestandardowych przy użyciu szablonów projektu Silverlight w środowisku Visual Studio, zobacz Podstawy kontrolek (Szybki start Silverlight).

Dodawanie nowych kontrolek i zastępowanie istniejących kontrolek

Możesz dodać do ekranu kontrolkę niestandardową jako nową kontrolkę lub zastępując istniejącą kontrolkę LightSwitch.

Aby dodać do ekranu kontrolkę niestandardową

W Drzewie zawartości ekranu zaznacz dowolną grupę.
U góry Projektanta ekranu, kliknij Dodaj element układu, a następnie kliknij przycisk Kontrolka niestandardowa.
W oknie dialogowym Dodaj kontrolkę niestandardową, rozwiń węzeł zestawu, rozwiń węzeł przestrzeni nazw, a następnie wybierz węzeł kontrolki.

Jeśli żądany zestaw nie pojawił się w oknie dialogowym Dodaj kontrolkę niestandardową, kliknij przycisk Dodaj odwołanie.W oknie dialogowym Dodaj odwołanie, wybierz zestaw lub lokalny projekt, który zawiera kontrolkę, której chcesz użyć, a następnie kliknij przycisk Ok.

[!UWAGA]

Jeśli kontrolka został utworzony przy użyciu szablonów projektu Silverlight środowiska Visual Studio i kontrolka została powiązana z danymi, poprzez modyfikację pliku XAML kontrolki, nie musisz wykonywać następnego kroku.Aby uzyskać więcej informacji na temat powiązania niestandardowej kontrolki z danymi modyfikując XAML kontrolki, zobacz Używanie kontrolek niestandardowych, aby wzbogacić interfejs użytkownika aplikacji LightSwitch.Jeśli kontrolka niestandardowa jest wbudowaną kontrolką Silverlight lub została utworzona przy użyciu szablonów projektu Silverlight środowiska Visual Studio, ale chcesz powiązać kontrolkę z danymi przy użyciu LightSwitch, przejdź do następnego kroku.
W polu Określ dane dla nowej kontrolki niestandardowej, wpisz nazwę danych ekranu, z którym chcesz powiązać kontrolkę, a następnie kliknij przycisk Ok.

Na przykład, jeśli pole listy niestandardowej ma wyświetlać nazwy z kolekcji o nazwie CustomerSet, wpisz CustomerSet.Jeśli kontrolka ma wyświetlać nazwę aktualnie wybranego odbiorcy, wpisz CustomerSet.SelectedItem.ContactName.
Dodaj kod, który powiąże dane z określoną właściwością kontrolki.Aby uzyskać więcej informacji, zobacz Powiązanie danych z właściwością kontrolki niestandardowej, niżej w tym dokumencie.

Aby użyć kontrolki niestandardowej do zastąpienia istniejącej kontrolki

W Drzewie zawartości ekranu, na liście rozwijanej obok kontrolki, którą chcesz zamienić, zaznacz Kontrolka niestandardowa.
W oknie Właściwości, obok pola Kontrolka niestandardowa, kliknij Zmień
W oknie dialogowym Dodaj kontrolkę niestandardową, rozwiń węzeł zestawu, rozwiń przestrzeń nazw, wybierz węzeł kontrolki, a następnie kliknij przycisk Ok.

Jeśli zestaw, który zawiera kontrolkę, nie pojawił się w oknie dialogowym Dodaj kontrolkę niestandardową, kliknij przycisk Dodaj odwołanie.W oknie dialogowym Dodaj odwołanie, wybierz zestaw lub lokalny projekt, który zawiera kontrolkę, której chcesz użyć, a następnie kliknij przycisk Ok.
Dodaj kod, który powiąże dane z określoną właściwością kontrolki.Aby uzyskać więcej informacji, zobacz Powiązanie danych z właściwością kontrolki niestandardowej, niżej w tym dokumencie.

Powiązanie danych z właściwością kontrolki niestandardowej

Musisz powiązać dane, które określono w oknie dialogowym Dodaj kontrolkę niestandardową, z określoną właściwością kontrolki niestandardowej.

Aby powiązać dane z właściwością kontrolki niestandardowej

W Projektancie ekranu, kliknij strzałkę obok przycisku Wpisz kod, a następnie kliknij dowolną metodę.

[!UWAGA]

Wybierz metodę, która zostanie wykonana zanim dane zostaną wyświetlone w formancie w czasie wykonywania, na przykład CustomerListDetail_Activated.

W edytorze kodu pojawi się blok metody.
W bloku metody, dodaj kod, który powiąże dane ekranu z właściwością formantu niestandardowego.

Poniższy przykład odwołuje się do kontrolki pola listy niestandardowej o nazwie Customers.Kod ten, powiąże kolekcję danych, która została określona w oknie dialogowym Dodaj kontrolkę niestandardową, z określoną właściwością pola listy.Kod ten określa również, że dane mogą zostać zmodyfikowane za pomocą tej kontrolki.
```
Private Sub CustomersListDetail_Activated()
    Me.FindControl("Customers").SetBinding( _
        System.Windows.Controls.ListBox.ItemsSourceProperty, _
                "Value", System.Windows.Data.BindingMode.TwoWay)
End Sub
```
```
partial void CustomersListDetail_Activated()
{
    this.FindControl("Customers").SetBinding(
        System.Windows.Controls.ListBox.ItemsSourceProperty,
        "Value", System.Windows.Data.BindingMode.TwoWay);
}
```