(String, StringCollection, String, UInt32, Boolean, Boolean, SPViewCollection.SPViewType, Boolean) del método SPViewCollection.Add
Crea una vista de la colección con el nombre especificado, el campos de la vista, consulta, el límite de filas, los valores de tipo Boolean que especifica si la vista muestra los elementos de página por página y si es la vista predeterminada, el tipo de vista y un valor booleano que especifica si la vista es personal o pública.
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Public Function Add ( _
strViewName As String, _
strCollViewFields As StringCollection, _
strQuery As String, _
iRowLimit As UInteger, _
bPaged As Boolean, _
bMakeViewDefault As Boolean, _
type As SPViewCollection.SPViewType, _
bPersonalView As Boolean _
) As SPView
'Uso
Dim instance As SPViewCollection
Dim strViewName As String
Dim strCollViewFields As StringCollection
Dim strQuery As String
Dim iRowLimit As UInteger
Dim bPaged As Boolean
Dim bMakeViewDefault As Boolean
Dim type As SPViewCollection.SPViewType
Dim bPersonalView As Boolean
Dim returnValue As SPView
returnValue = instance.Add(strViewName, _
strCollViewFields, strQuery, iRowLimit, _
bPaged, bMakeViewDefault, type, bPersonalView)
public SPView Add(
string strViewName,
StringCollection strCollViewFields,
string strQuery,
uint iRowLimit,
bool bPaged,
bool bMakeViewDefault,
SPViewCollection.SPViewType type,
bool bPersonalView
)
Parámetros
strViewName
Tipo: System.StringUna cadena que contiene el nombre de la vista.
strCollViewFields
Tipo: System.Collections.Specialized.StringCollectionUna colección que contiene los nombres internos de los campos de la vista.
strQuery
Tipo: System.StringUna cadena de Lenguaje de marcado de aplicación de colaboración (CAML) que contiene la cláusula Where de la consulta.
iRowLimit
Tipo: System.UInt32El número máximo de elementos para devolver en la vista. Al especificar un valor mayor que Int32.MaxValue (2.147.483.647 o hexadecimal 0x7FFFFFFF) produce una excepción porque el valor está fuera del intervalo.
bPaged
Tipo: System.Booleantrue para especificar que la vista permite mostrar más elementos de página por página; en caso contrario, false.
bMakeViewDefault
Tipo: System.Booleantrue para realizar la vista de la vista predeterminada; en caso contrario, false.
type
Tipo: Microsoft.SharePoint.SPViewCollection.SPViewTypeUn valor de enumeración que especifica el tipo de vista.
bPersonalView
Tipo: System.Booleantrue para crear una vista personal; false para crear una vista pública.
Valor devuelto
Tipo: Microsoft.SharePoint.SPView
La nueva vista.
Excepciones
Excepción | Condición |
---|---|
InvalidOperationException | El tipo de vista especificado no es válido para el tipo de plantilla de lista. |
Ejemplos
En el ejemplo de código siguiente se crea una vista de cuadrícula y muestra elementos donde un valor de campo es menor que 1.000.
Dim siteCollection As SPSite = SPControl.GetContextSite(Context)
Dim site As SPWeb = siteCollection.AllWebs("Site_Name")
Dim list As SPList = site.Lists("List_Name")
Dim views As SPViewCollection = list.Views
Dim viewName As String = "View_Name"
Dim viewFields As New System.Collections.Specialized.StringCollection()
viewFields.Add("Field1_Name")
viewFields.Add("Field2_Name")
viewFields.Add("Field3_Name")
Dim query As String = "<Where><Lt><FieldRef Name='<iterm>Field3_Name</iterm>'/>" _
& "<Value Type='Integer'>1000</Value></Lt></Where>"
views.Add(viewName, viewFields, query, 100, True, False, Microsoft.SharePoint.SPViewCollection.SPViewType.Grid, False)
SPSite oSiteCollection = SPContext.Current.Site;
using (SPWeb oWebsite = oSiteCollection.AllWebs["Website_Name"])
{
SPList oList = oWebsite.Lists["List_Name"];
SPViewCollection collViews = oList.Views;
string strViewName = "View_Name";
System.Collections.Specialized.StringCollection collViewFields = new System.Collections.Specialized.StringCollection();
collViewFields.Add("Field1_Name");
collViewFields.Add("Field2_Name");
collViewFields.Add("Field3_Name");
string strQuery = "<Where><Eq><FieldRef Name=\"Field3_Name\"/>" +
"<Value Type=\"Text\">Text</Value></Eq></Where>";
collViews.Add(strViewName, collViewFields, strQuery, 100, true, false);
}
Nota
Determinados objetos implementan la interfaz de IDisposable y, a continuación, se debe evitar la conservación de estos objetos en la memoria que ya no se necesitan. Para obtener información acerca de buenas prácticas de codificación, vea Disposing Objects.