Personalizar as consultas de itens de lista e filtrar os dados para os aplicativos do Windows Phone

Artigo
03/21/2023

Personalize as consultas de dados nas quais as modos de exibições em um aplicativo Windows Phone se baseiam.

Com projetos criados usando o modelo de aplicativo para Windows Phone SharePoint lista, os desenvolvedores podem tirar proveito de um padrão de design implementado no modelo que lhes permite personalizar as partes da camada de dados para um aplicativo do Windows Phone. Um modo de exibição de uma lista do SharePoint em um aplicativo do Windows Phone pode ser configurado no Microsoft SharePoint Server e incluído como está no aplicativo no telefone ou um modo de exibição personalizado pode ser criado para o aplicativo.

Importante

Se você estiver desenvolvendo um aplicativo para Windows Phone 8, deverá usar Visual Studio Express 2012 em vez do Visual Studio 2010 Express. Com exceção do ambiente de desenvolvimento, todas as informações neste artigo se aplicam à criação de aplicativos para Windows Phone 8 e Windows Phone 7. > Para obter mais informações, consulte Como configurar um ambiente para desenvolver aplicativos móveis para o SharePoint.

Configurar modos de exibição de lista no servidor para uso nos aplicativos do Windows Phone

Quando você cria um aplicativo de lista do SharePoint para um telefone Windows usando o modelo de aplicativo para Windows Phone SharePoint lista, você pode optar por incluir em seu aplicativo qualquer modos de exibição existentes que estão associados a lista do SharePoint de destino. Uma das maneiras a filtrar os itens em uma lista do SharePoint como a lista é exibida no telefone, em seguida, é configurar uma exibição filtrada para a lista no servidor e depois selecione naquele modo de exibição a serem incluídos no seu aplicativo do Windows Phone. O Assistente de modelo de aplicativo para Windows Phone SharePoint lista gera uma consulta Collaborative Application Markup Language (CAML) para o modo de exibição selecionado que inclui as condições de filtragem configuradas para o modo de exibição no servidor. Por exemplo, você poderia, tem uma lista no servidor que é baseado no modelo de lista de tarefas. Você pode criar um modo de exibição para a lista chamado "Festa" que inclui somente os itens relacionados, por exemplo, o planejamento de uma festa de feriado de empresa, adicionando uma condição de filtro para mostrar itens de lista somente quando o campo de descrição contém as palavras "feriado" ou "de terceiros". Em que o aplicativo do Windows Phone, a marcação CAML gerada para o modo de exibição seria semelhante ao seguinte (dependendo os campos a serem incluídos no seu aplicativo foi escolhidos).

<View>
    <Query>
        <Where>
            <Or>
                <Contains>
                    <FieldRef Name='Body' />
                    <Value Type='Note'>holiday</Value>
                </Contains>
                <Contains>
                    <FieldRef Name='Body' />
                    <Value Type='Note'>party</Value>
                </Contains>
            </Or>
        </Where>
    </Query>
    <RowLimit>30</RowLimit>
    <ViewFields>
        <FieldRef Name='Title'/>
        <FieldRef Name='Body'/>
        <FieldRef Name='AssignedTo'/>
        <FieldRef Name='Status'/>
        <FieldRef Name='PercentComplete'/>
        <FieldRef Name='StartDate'/>
        <FieldRef Name='DueDate'/>
        <FieldRef Name='Checkmark'/>
    </ViewFields>
</View>

Assim como acontece com outros modos de exibição existentes da lista de tarefas que você deseja incluir no seu aplicativo do Windows Phone quando você cria o seu projeto, um controle de PivotItem correspondente ao modo de exibição escolhido é adicionado ao controle Pivot que constitui o elemento de interface (UI) principal do usuário no aplicativo.

Personalizar as consultas de modo de exibição de lista no aplicativo do Windows Phone

Para um ou outro motivo, talvez não seja possíveis ou razoáveis configurar modos de exibição que atendam a todas as suas necessidades de design para uma determinada lista no servidor. Em um projeto de Microsoft Visual Studio criado usando o modelo de aplicativo para Windows Phone SharePoint lista, aspectos do que pode ser chamado a camada de dados são disponibilizados para os desenvolvedores, principalmente através do arquivo de ListDataProvider.cs no projeto. Você pode modificar o CAML definido para uma exibição existente, ou você pode adicionar consultas CAML para novas exibições no arquivo ListDataProvider.cs.

O arquivo ListDataProvider.cs

Em um projeto baseado no modelo de aplicativo para Windows Phone SharePoint lista, o arquivo de ListDataProvider.cs define objetos que fornecem para acessar e configurar uma lista do SharePoint como uma fonte de dados para os modos de exibição do aplicativo do Windows Phone em. No arquivo List.xaml, que define a página principal do aplicativo para o aplicativo, um controle Pivot (próprio contendo os controles de PivotItem filho) é declarado com um manipulador de eventos atribuído ao seu evento LoadedPivotItem. O método LoadDataFromServer no arquivo ListDataProvider.cs basicamente é chamado quando um controle PivotItem (que é usado como o contêiner de renderização para itens de lista em que o aplicativo do Windows Phone) é carregado na página principal do aplicativo do aplicativo.

PivotItem associado a um modo de exibição de lista de dado é carregada na interface de usuário.
No arquivo List.xaml.cs, o manipulador para o evento LoadedPivotItem chama o método LoadData implementado no arquivo ListViewModel.cs, passando o nome do controle PivotItem que terminou o carregamento. (No design de projetos com base no modelo Windows Phone Aplicativo de Lista do SharePoint, o nome de um determinado controle PivotItem é definido como o mesmo que o valor chave para a cadeia de consulta CAML para a exibição associada a esse controle no tipo dicionárioViewXmls definido na classe CamlQueryBuilder em ListViewModel.cs.)
O método LoadData no ListViewModel.cs chama o método de LoadData implementado no arquivo ListDataProvider.cs.
O método LoadData no ListDataProvider.cs chama o método de LoadDataFromServer também é implementado no mesmo arquivo. O método LoadDataFromServer, em seguida, faz o seguinte:
1. Obtém a cadeia de caracteres de consulta CAML associada a um determinado modo de exibição.
```
CamlQuery query = CamlQueryBuilder.GetCamlQuery(ViewName);
```
2. A lista a ser recuperada do modelo de registradores com o objeto do cliente.
```
ListItemCollection items = Context.Web.Lists.GetByTitle(ListTitle).GetItems(query);
```
3. Indica o modelo de objeto do cliente que ele deve retornar os itens de lista e os campos desses itens de lista (como valores de texto).
```
Context.Load(items);
Context.Load(items, listItems => listItems.Include(item => item.FieldValuesAsText));
```
4. Chama ExecuteQueryAsync para enviar solicitações para SharePoint Server e recupera os dados (de maneira assíncrona).

Adicionar uma consulta de exibição de lista personalizada e a interface de usuário correspondente elementos

Em seus próprios projetos, você pode tirar proveito da maneira como a camada de dados foi projetada para adicionar suas próprias cadeias de caracteres de consulta CAML personalizadas e modos de exibição de lista.

Para o exemplo de código a seguir, suponha novamente que a instalação de destino do SharePoint Server tenha uma lista de Pedidos de Produto criada a partir do modelo de Lista Personalizada, configurada com os campos e tipos indicados na Tabela 1 no tópico Como: Implementar lógica de negócios e validação de dados em um aplicativo Windows Phone para SharePoint. Crie um projeto com base no modelo Windows Phone Aplicativo de Lista do SharePoint que usa uma lista como a lista de Pedidos de Produto como fonte (conforme descrito em Como: Criar um aplicativo de lista do SharePoint Windows Phone). Para fins deste exemplo, adicionamos uma exibição personalizada ao aplicativo Windows Phone (não à lista no server.md) que é filtrada para exibir apenas os pedidos de produto em que a quantidade ordenada é 100 ou mais.

Para adicionar uma consulta personalizada e o modo de exibição

No Solution Explorer, clique duas vezes no arquivo ListDataProvider.cs (ou escolha o arquivo e pressioneF7) para abrir o arquivo para edição.

Atualize a definição do tipo DicionárioViewXmls na classe CamlQueryBuilder estática para incluir uma consulta CAML adicional, com uma cláusula WHERE estipulando a condição de filtragem apropriada.

static Dictionary<string, string> ViewXmls = new Dictionary<string, string>()
{
    {"View1",   @"<View><Query><OrderBy><FieldRef Name='ID'/>
        </OrderBy></Query><RowLimit>30</RowLimit><ViewFields>{0}</ViewFields></View>"},
    {"View2",   @"<View><Query><OrderBy><FieldRef Name='ID' /></OrderBy>
     <Where><Geq><FieldRef Name='Quantity' />
          <ValueType='Number'>100</Value>
                </Geq></Where>
             </Query><RowLimit>30</RowLimit>
               <ViewFields>{0}</ViewFields></View>"}
};

Clique duas vezes no arquivo de List.xaml para abrir o arquivo para edição.

Adicione marcação para definir um controle de PivotItem filho adicionais dentro do controle principal Pivot. O elemento Grid no qual os elementos de interface do usuário que definem a página principal do aplicativo são declarados deve se parecer com o código a seguir.

<Grid x:Name="LayoutRoot" Background="Transparent"
 xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
 xmlns:controls="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls">
    <!--Pivot Control-->
    <ProgressBar x:Name="progressBar" Opacity="1" HorizontalAlignment="Center"
     VerticalAlignment="Top" Height="30" Width="470" IsIndeterminate="{Binding IsBusy}"
     Visibility="{Binding ShowIfBusy}" />
    <Grid x:Name="ContentPanel" Grid.Row="0" Width="470">
        <controls:Pivot Name="Views" Title="Product Orders" LoadedPivotItem="OnPivotItemLoaded">
            <!--Pivot item-->
            <controls:PivotItem Name="View1" Header="All Items">
                <!--Double line list with text wrapping-->
                <ListBox x:Name="lstBox1" Margin="0,0,-12,0" SelectionChanged="OnSelectionChanged"
                 ItemsSource="{Binding [View1]}">
                    <ListBox.ItemTemplate>
                        <DataTemplate>
                            <StackPanel Orientation="Vertical" Margin="10">
                                <TextBlock Name="txtTitle" Text="{Binding [Title]}"
                                 TextWrapping="NoWrap" Style="{StaticResource PhoneTextTitle2Style}" />
                                <TextBlock Name="txtDescription" Text="{Binding [Description]}"
                                 TextWrapping="NoWrap" Style="{StaticResource PhoneTextNormalStyle}" />
                                <TextBlock Name="txtQuantity" Text="{Binding [Quantity]}"
                                 TextWrapping="NoWrap" Style="{StaticResource PhoneTextNormalStyle}" />
                            </StackPanel>
                        </DataTemplate>
                    </ListBox.ItemTemplate>
                </ListBox>
            </controls:PivotItem>

            <!--Added PivotItem control for customized view--><controls:PivotItem Name="View2" Header="Big Orders"><!--Double line list with text wrapping--><ListBox x:Name="lstBox2" Margin="0,0,-12,0"
                 SelectionChanged="OnSelectionChanged" ItemsSource="{Binding [View2]}"><ListBox.ItemTemplate><DataTemplate><StackPanel Orientation="Vertical" Margin="10"><TextBlock Name="txtTitle" Text="{Binding [Title]}"
                                 TextWrapping="NoWrap" Style="{StaticResource PhoneTextTitle2Style}" /><TextBlock Name="txtDescription" Text="{Binding [Description]}"
                                 TextWrapping="NoWrap" Style="{StaticResource PhoneTextNormalStyle}" /><TextBlock Name="txtQuantity" Text="{Binding [Quantity]}"
                                 TextWrapping="NoWrap" Style="{StaticResource PhoneTextNormalStyle}" /></StackPanel></DataTemplate></ListBox.ItemTemplate></ListBox></controls:PivotItem>

        </controls:Pivot>
    </Grid>
</Grid>

Observação

[!OBSERVAçãO] Em particular que o valor do atributo Name ("ModoDeExibição2") do PivotItem controle é o mesmo que o valor da chave da entrada adicionado ao tipo Dictionary definido na etapa 2. Esse valor é usado para identificar a consulta CAML apropriada usar para recuperar os dados a serem exibidos no PivotItem. Também Observe que o ListBox declarado aqui (chamado "lstBox2" simplesmente para diferenciá-lo do ListBox para o modo de exibição padrão) também está vinculado ao modo de exibição.

Quando você inicia o seu projeto (pressionando F5), o controle de Pivot para o aplicativo inclui os dois controles de PivotItem e os dados recuperados por consultas CAML associadas com suas respectivas exibições. O modo de exibição de todos os itens do padrão exibe todos os pedidos, conforme mostrado na Figura 1 (com dados de amostra).

Figura 1. All orders (list items) in a sample list

All orders (list items) in a sample list

E o modo de exibição personalizado, conforme definido no procedimento anterior, exibe uma lista filtrada de itens que inclui apenas as ordens para o qual uma quantidade de 100 ou mais for especificada, conforme mostrado na Figura 2.

Figura 2. Only the big orders

Only the big orders

Você pode fazer muitas outras personalizações às consultas CAML baseados nos quais modos de exibição e para os elementos de interface do usuário associados modos de exibição.