(String, StringCollection, String, UInt32, Boolean, Boolean) del método SPViewCollection.Add
Crea una vista de la colección con el nombre especificado, campos de la vista, consulta, el límite de filas y valores booleanos que especifica si la vista muestra los elementos de página por página y si es la vista predeterminada.
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 _
) 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 returnValue As SPView
returnValue = instance.Add(strViewName, _
strCollViewFields, strQuery, iRowLimit, _
bPaged, bMakeViewDefault)
public SPView Add(
string strViewName,
StringCollection strCollViewFields,
string strQuery,
uint iRowLimit,
bool bPaged,
bool bMakeViewDefault
)
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 aplicaciones de colaboración 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.
Valor devuelto
Tipo: Microsoft.SharePoint.SPView
La nueva vista.
Ejemplos
En el ejemplo de código siguiente se crea una vista que devuelve los elementos donde el valor de un campo es igual a un valor de texto especificado.
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><Eq>
<FieldRef Name='<iterm>Field3_Name</iterm>'/>" _
& "<Value Type='Text'><iterm>Text</iterm></Value></Eq></Where>"
views.Add(viewName, viewFields, query, 100, True, 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><Lt><FieldRef Name=\"Field3_Name\"/>" +
"<Value Type=\"Integer\">1000</Value></Lt></Where>";
collViews.Add(strViewName, collViewFields, strQuery, 100, true, false,
Microsoft.SharePoint.SPViewCollection.SPViewType.Grid, 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.