NamedRange.Merge (Método)
Crea una celda combinada a partir del control NamedRange.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
Sub Merge ( _
Across As Object _
)
void Merge(
Object Across
)
Parámetros
- Across
Tipo: System.Object
Es true para combinar las celdas de cada fila del rango especificado como celdas combinadas separadas.El valor predeterminado es false.
Comentarios
El valor de un rango combinado se especifica en la celda situada en la esquina superior izquierda del control NamedRange.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
En el siguiente ejemplo de código se muestra el valor de las propiedades MergeArea y MergeCells de una sola celda NamedRange antes y después de utilizar el método Merge para combinar un NamedRange de varias celdas que contiene el NamedRange de una única celda.
Se trata de un ejemplo para una personalización en el nivel del documento.
Private Sub MergeRange()
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
"namedRange1")
Dim namedRange2 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1"), "namedRange2")
Dim beforeMergeAddress As String = _
namedRange2.MergeArea.Address(, , _
Excel.XlReferenceStyle.xlA1, , )
MessageBox.Show("Before merging, the MergeArea property is '" & _
beforeMergeAddress & "' and the MergeCells property is " & _
" '" & namedRange2.MergeCells.ToString() & "'.")
namedRange1.Select()
namedRange1.Merge(False)
Dim afterMergeAddress As String = _
namedRange2.MergeArea.Address(, , _
Excel.XlReferenceStyle.xlA1, , )
MessageBox.Show("After merging, the MergeArea property is '" & _
afterMergeAddress & "' and the MergeCells property is " & _
" '" & namedRange2.MergeCells.ToString() & "'.")
End Sub
private void MergeRange()
{
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1", "A5"],
"namedRange1");
Microsoft.Office.Tools.Excel.NamedRange namedRange2 =
this.Controls.AddNamedRange(this.Range["A1"],
"namedRange2");
string beforeMergeAddress = namedRange2.MergeArea.get_Address(
Excel.XlReferenceStyle.xlA1);
MessageBox.Show("Before merging, the MergeArea property is '" +
beforeMergeAddress + "' and the MergeCells property is " +
" '" + namedRange2.MergeCells.ToString() + "'.");
namedRange1.Select();
namedRange1.Merge(false);
string afterMergeAddress = namedRange2.MergeArea.get_Address(
Excel.XlReferenceStyle.xlA1);
MessageBox.Show("After merging, the MergeArea property is '" +
afterMergeAddress + "' and the MergeCells property is " +
" '" + namedRange2.MergeCells.ToString() + "'.");
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.