Elemento Row (dsQueryResponse)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Representa uma linha de dados da lista. Os campos e as propriedades de metadados do item de lista que a linha contém são representados por atributos do elemento Row . Alguns campos, dependendo do tipo de dados, podem ser representados por atributos adicionais que apresentam o valor do campo em um formato diferente.

<Row
  Attachments="Integer"
  ContentTypeId="GUID"
  File_x0020_Type="String"
  FileLeafRef="String"
  FileLeafRef.Name="String"
  FileLeafRef.Suffix="String"
  FSObjType="Integer"
  HTML_x0020_File_x0020_Type.File_x0020_Type.mapall="String"
  HTML_x0020_File_x0020_Type.File_x0020_Type.mapcon="String"
  HTML_x0020_File_x0020_Type.File_x0020_Type.mapico="String"
  ID="Integer"
  PermMask="Hex"
  some_field="type appropriate to the field"
  some_booleanField.Value="Integer"
  some_date_time_field.ifnew="Integer"
  some_date_time_field.="unlocalized DateTime"
  some_date_time_field.DateOnly="date"
  some_date_time_field.TimeOnly="time"
  some_date_time_field.ISO8601="ISO8601 compliant DateTime"
  some_date_time_field.MonthDayOnly="month and day"
  some_date_time_field.MonthYearOnly="month and year"
  some_user_field="String"
  some_user_field.id="Integer"
  some_user_field.title="String"
  some_user_field.span="String"
  some_url_field.desc="String"
/>

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
Anexos	Obrigatório. 1 se o item de lista tiver um ou mais anexos; caso contrário, 0.
ContentTypeId	Obrigatório. O GUID do tipo de conteúdo do item de lista no formato ox GUID_without_hyphens.
File_x0020_Type	Necessário, mas ignorado se a lista não for uma biblioteca de documentos. O tipo de arquivos em uma biblioteca de documentos. Cadeia de caracteres vazia quando a lista não é uma biblioteca de documentos.
FileLeafRef	Necessário, mas ignorado se a lista não for uma biblioteca de documentos. A URL relativa ao servidor do documento. Este é o nome da pasta, seguido por `"_."`, seguido pelo nome do arquivo. Um exemplo é `QuarterlySummaries_.Quarter1.docx`. Esse valor de atributo é a concatenação dos valores do atributo FileLeafRef.Name e do atributo FileLeafRef.Suffix com um `"."` caractere separador.
FileLeafRef.Name	Necessário, mas ignorado se a lista não for uma biblioteca de documentos. O nome da pasta que contém o documento, seguido por um caractere sublinhado; por exemplo, `QuarterlySummaries_.`
FileLeafRef.Suffix	Necessário, mas ignorado se a lista não for uma biblioteca de documentos. O nome do arquivo de documento; por exemplo, `Quarter1.docx`.
FSObjType	Obrigatório. 1 se o item de lista for uma pasta; caso contrário, 0.
HTML_x0020_File_x0020_Type.File_x0020_Type.mapall	Opcional. O valor retornado por uma chamada da função MapToAll durante a transformação XSLT. Para obter mais informações, consulte MapToAll Element (View) e SharePoint Data View Web Part Extension Functions no namespace ddwrt.
HTML_x0020_File_x0020_Type.File_x0020_Type.mapcon	Opcional. O valor retornado por uma chamada da função MapToControl durante a transformação XSLT. Para obter mais informações, consulte MapToControl(SPWeb, String, String), elemento MapToControl (View)e SharePoint Data View Web Part Extension Functions no namespace ddwrt.
HTML_x0020_File_x0020_Type.File_x0020_Type.mapico	Opcional. O valor retornado por uma chamada da função MapToIcon durante a transformação XSLT. Para obter mais informações, consulte Icon(), MapToIcon Element (View)e SharePoint Data View Web Part Extension Functions no namespace ddwrt.
ID	Obrigatório. A ID do item de lista.
PermMask	As permissões mascaram para o item de lista.
some_field	Necessário para cada campo não oculto no item de lista. Para cada campo desse tipo, há um atributo que tem o mesmo nome que o nome interno do campo.
some_field	Opcional. Os tipos de campo de pesquisa, número e moeda no SharePoint Foundation podem ter uma formatação de baixo nível mesmo antes de qualquer formatação HTML ser aplicada. Por exemplo, um valor de moeda negativo é fechado em parênteses. O atributo de cada campo desse tipo é imediatamente seguido por outro atributo que tem o mesmo nome, ao qual um `"."` caractere é acrescentado. Esse atributo fornece o valor de campo como dados não formatados brutos. Por exemplo, um valor de moeda negativo é procedido por um sinal de menos (`"-"`) e não está em parênteses.
some_booleanField. Valor	Opcional. Cada atributo booliano no item de lista é seguido por outro atributo que tem o mesmo nome, ao qual `".Value"` é acrescentado. Esse atributo fornece a forma nãocalizada bruta do valor de campo (1 ou 0), enquanto o atributo principal para o campo booliano fornece o valor relativizado para a localidade do site.
some_date_time_field.ifnew	Opcional. 1 se o valor da data/hora for recente o suficiente para definir o item de lista como novo; caso contrário, 0. Esse atributo será exibido somente se o some_date_time_field for "Created_x0020_Date".
some_date_time_field	Opcional. Se houver um atributo para um campo datetime cujo valor é localizado, há também um atributo que tem o mesmo nome, ao qual um `"."` caractere é acrescentado. Esse atributo fornece o valor bruto de um campo datetime como armazenado no banco de dados de conteúdo no formato ISO8601.
some_date_time_field. DateOnly	Opcional. O valor de um campo DateTime com apenas a data. Usado apenas em listas relacionadas ao blog.
some_date_time_field. TimeOnly	Opcional. O valor de um campo DateTime com apenas a hora do dia. Usado apenas em listas relacionadas ao blog.
some_date_time_field. ISO8601	Opcional. O valor de um campo DateTime formatado em conformidade com ISO8601. Usado apenas em listas relacionadas ao blog.
some_date_time_field. MonthDayOnly	Opcional. O valor de um campo DateTime com apenas o mês e o dia do mês. Usado apenas em listas relacionadas ao blog.
some_date_time_field. MonthYearOnly	Opcional. O valor de um campo DateTime com apenas o mês e o ano. Usado apenas em listas relacionadas ao blog.
some_user_field.id	Opcional. Se qualquer atributo representa um campo tipo usuário, há outro atributo que tem o mesmo nome, ao qual `".id"` é acrescentado. Este é o número de ID relativo ao site do usuário.
some_user_field.title	Opcional. Se qualquer atributo representa um campo tipo usuário, há outro atributo que tem o mesmo nome, ao qual `".title"` é acrescentado. Este é o nome do usuário, por exemplo, "Michiyo Sato". Observe que o valor do atributo principal, some_user_field, é a marcação de intervalo HTML para o usuário, incluindo, por exemplo, informações de presença. Confira o trecho de código abaixo da tabela para obter um exemplo.
some_user_field.span	Opcional. Se qualquer atributo representa um campo tipo usuário, há outro atributo que tem o mesmo nome, ao qual `".span"`é acrescentado. Esta é uma versão mais clara da marcação HTML para o usuário. Confira o trecho de código abaixo da tabela para obter um exemplo.
some_url_field.desc	Opcional. Se qualquer atributo representa um campo de URL, há outro atributo que tem o mesmo nome, ao qual ".desc" é acrescentado. Isso fornece uma descrição da URL.

Essa marcação é usada para renderizar o campo quando o sinalizador FreeForm da propriedade ListViewWebPart.ViewFlags não estiver definido; caso contrário, o valor do atributo some_user_field.span é usado.

<span class="ms-imnSpan">
  <a href='javascript:;' onclick='IMNImageOnClick(event);return false;' class='ms-imnlink'>
    <img name='imnmark' class='ms-imnImg' title='' border='0' height='12' width='12'
         src='/_layouts/images/blank.gif'
         alt='No presence information'
         sip='MichiyoS@Contoso.com'
         id='imn_1,type=smtp' />
  </a>
  <a onclick="GoToLink(this);return false;" href="/sites/Contoso/_layouts/userdisp.aspx?ID=1">Michiyo Sato</a>
</span>

Essa marcação é usada para renderizar o campo quando o sinalizador FreeForm da propriedade ListViewWebPart.ViewFlags é definido; caso contrário, o valor do atributo some_user_field.title é usado.

<nobr>
  <span>
    <a onclick="GoToLink(this);return false;" href="/sites/Contoso/_layouts/userdisp.aspx?ID=1">Michiyo Sato</a>
    <img border="0" height="1" width="3" src="/_layouts/images/blank.gif"/><a href='javascript:;' onclick='IMNImageOnClick(event);return false;' class='ms-imnlink'>
    <img name='imnmark' class='ms-imnImg' title='' border='0' height='12' width='12'
         src='/_layouts/images/blank.gif'
         alt='No presence information'
         sip='MichiyoS@Contoso.com' id='imn_2,type=smtp'/></a>
  </span>
</nobr>

Elementos filho

Nenhum

Elementos pai

Rows

Occurrences

Mínimo: 0
Máximo: o valor do atributo RowLimit do elemento pai dsQueryResponse

Exemplo

Para obter um exemplo, consulte Exemplos de árvores de nó de entrada e de resultado em transformações XSLT.

Partilhar via