del método SPWeb.GetListItemFields
Obtiene el elemento de lista que está asociado con la dirección URL relativa al servidor especificada, devolución de datos de solo los campos especificados.
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Public Function GetListItemFields ( _
strUrl As String, _
ParamArray fields As String() _
) As SPListItem
'Uso
Dim instance As SPWeb
Dim strUrl As String
Dim fields As String()
Dim returnValue As SPListItem
returnValue = instance.GetListItemFields(strUrl, _
fields)
public SPListItem GetListItemFields(
string strUrl,
params string[] fields
)
Parámetros
strUrl
Tipo: System.StringLa URL relativa al servidor, como "/sites/MySite/Shared Documents/MyDocument.docx".
fields
Tipo: []Los nombres de los campos para la que se devuelven los valores en el elemento de lista.
Valor devuelto
Tipo: Microsoft.SharePoint.SPListItem
El elemento de lista.
Excepciones
Excepción | Condición |
---|---|
ArgumentNullException | fields o strUrl es nulo . |
Comentarios
Si fields es una matriz vacía, este método no devuelve un valor para cualquiera de los campos para el elemento de lista.
Este método sólo obtiene los valores de los campos especificados en el elemento de lista. Para obtener un elemento de lista basado en un identificador de elemento de lista, utilice el método GetItemByIdSelectedFields(Int32, []) .
Ejemplos
En el siguiente ejemplo es una aplicación de consola que recupera un elemento de lista mediante la especificación de una dirección URL y una matriz de nombres de campo. Después de recupera el elemento, la aplicación imprime los valores de campo en la consola.
Imports System
Imports Microsoft.SharePoint
Module ConsoleApp
Sub Main()
Using site As SPSite = New SPSite("https://localhost")
Using web As SPWeb = site.OpenWeb()
' Build a server-relative Url for a list item.
Dim itemUrl As String = web.RootFolder.ServerRelativeUrl
itemUrl += "_catalogs/masterpage/default.master"
' Make a list of fields to fetch.
Dim itemFields() As String = {"ContentTypeId", _
"ContentType", _
"HTML_x0020_File_x0020_Type", _
"EncodedAbsUrl", _
"FileLeafRef", _
"UniqueId", _
"FileSizeDisplay"}
' Get the list item.
Dim item As SPListItem = web.GetListItemFields(itemUrl, itemFields)
' Print the values to the console.
Dim fieldName As String
For Each fieldName In itemFields
Console.WriteLine("{0} = {1}", fieldName, item(fieldName))
Next
End Using
End Using
Console.ReadLine()
End Sub
End Module
using System;
using Microsoft.SharePoint;
namespace Test
{
class ConsoleApp
{
static void Main(string[] args)
{
using (SPSite site = new SPSite("https://localhost"))
{
using (SPWeb web = site.OpenWeb())
{
// Build a server-relative Url for a list item.
string itemUrl = web.RootFolder.ServerRelativeUrl;
itemUrl += "_catalogs/masterpage/default.master";
// Make a list of fields to fetch.
string[] itemFields =
{
"ContentTypeId",
"ContentType",
"HTML_x0020_File_x0020_Type",
"EncodedAbsUrl",
"FileLeafRef",
"UniqueId",
"FileSizeDisplay"
};
// Get the list item.
SPListItem item = web.GetListItemFields(itemUrl, itemFields);
// Print the values to the console.
foreach (string fieldName in itemFields)
Console.WriteLine("{0} = {1}", fieldName, item[fieldName]);
}
}
Console.ReadLine();
}
}
}
Imports System
Imports System.Collections.Generic
Imports System.Globalization
Imports System.Text
Imports Microsoft.SharePoint
Module ConsoleApp
Sub Main()
Using site As New SPSite("https://localhost")
Using web As SPWeb = site.OpenWeb()
If web.IsMultilingual Then
Dim sb As New StringBuilder()
Dim sep As String = ", "
Dim cultures As IEnumerable(Of CultureInfo) = web.SupportedUICultures
For Each culture As CultureInfo In cultures
sb.Append(culture.Name)
sb.Append(sep)
Next
Dim str As String = sb.ToString().Trim(sep.ToCharArray())
Console.WriteLine("Supported cultures: {0}", str)
End If
Console.WriteLine("Default culture: {0}", web.UICulture.Name)
End Using
End Using
Console.WriteLine(vbCrLf + "Press ENTER to continue....")
Console.Read()
End Sub
End Module