Cómo: Agregar una propiedad local a una pantalla de Silverlight

Puede agregar un campo llamado propiedad local a una pantalla.Puede utilizar una propiedad local para recoger un valor de entrada o mostrar un valor calculado.

Para crear una propiedad local

1. En la parte superior del Diseñador de pantallas, haga clic en Agregar elemento de datos.

   Aparecerá el cuadro de diálogo Agregar elemento de datos.

2. En el cuadro de diálogo Agregar elemento de datos, seleccione Propiedad local.

3. En la lista desplegable Tipo, elija un tipo para la propiedad local.

   Puede seleccionar cualquiera de los tipos estándar, como Cadena, Número entero, Dirección de correo electrónico, o cualquiera de las entidades que están asociadas a su aplicación, como Cliente, Detalle de pedido o Producto.

4. Seleccione Es obligatoria si desea exigir que este campo contenga un valor.

   [!NOTA]

   Si el campo no contiene un valor cuando el usuario intenta abrir la pantalla, aparece un mensaje de validación.

5. En el cuadro Nombre, escriba un nombre y haga clic en Aceptar.

   El cuadro de diálogo Agregar elemento de datos se cerrará.La propiedad local aparece en lista Miembros de pantalla.

Para agregar una propiedad local a una pantalla

1. En el lista Miembros de pantalla, arrastre la propiedad local a la ubicación deseada del Árbol de contenido de pantalla.

2. En el Árbol de contenido de pantalla, en la lista desplegable que aparece al lado de la propiedad local, seleccione el tipo de pantalla deseado.

   Por ejemplo, si está creando una propiedad local para mostrar un valor monetario, puede cambiar el tipo mostrado a Editor de divisas o Visor de divisas.Igualmente, puede mostrar una propiedad de cadena local como un Cuadro de texto o una Etiqueta.

Para aplicar las reglas de validación a una propiedad local

1. En la lista Miembros de pantalla, seleccione la propiedad local.

2. En la ventana Propiedades, expanda el nodo Validación si aún no lo está.

   Las reglas de validación disponibles variarán, dependiendo del tipo de propiedad local.

3. Si la propiedad local debe tener un valor, seleccione Es obligatoria.

   Seleccione cualquier otra regla de validación que desee aplicar a la propiedad local.

4. Si necesita realizar una validación más compleja, haga clic en Validación personalizada.

   Aparece el Editor de código.LightSwitch genera un método denominado localPropertyName_Validate.Puede agregar lógica de validación personalizada al método.El siguiente ejemplo muestra un mensaje de error si el usuario escribe menos de tres caracteres para una propiedad local denominada CityCode.

   Private Sub CityCode_Validate(results As ScreenValidationResultsBuilder)
       If Me.CityCode.Length < 3 Then
           results.AddPropertyError("This string must have at least 3 letters.")
       End If
   End Sub
   

   partial void CityCode_Validate
       (ScreenValidationResultsBuilder results)
   {
       if (this.CityCode.Length < 3)
       {
           results.AddPropertyError("This string must have at least 3 letters.");
       }
   
   }
   

   Si la cadena no contiene al menos tres caracteres, la propiedad se describirá en rojo y aparece el mensaje de error escrito anteriormente.

Para asignar un valor a una propiedad local usando código

• Puede establecer un valor en una propiedad local usando código.

  En el siguiente ejemplo establece el valor de una propiedad local llamada ApprovedCheckBox en False.

  Private Sub OrdersListDetail_InitializeDataWorkspace _
      (saveChangesTo As System.Collections.Generic.List _
       (Of Microsoft.LightSwitch.IDataService))
      ApproveCheckBox = False
  
  End Sub
  

  partial void ApprovedCheckBox_Validate
      (ScreenValidationResultsBuilder results)
  {
      ApprovedCheckBox = false;
  
  }
  

Vea también

Tareas

Cómo: Agregar un comando personalizado a una pantalla de Silverlight

Cómo: Diseñar una pantalla de Silverlight mediante el Diseñador de pantallas

Otros recursos

Pantallas: La interfaz de usuario de la aplicación