Actualización de un formato de rango en Excel

Artículo
08/22/2024

En este artículo se describe cómo usar las API de gráficos y libros de Excel en Microsoft Graph para actualizar las propiedades rangeFormat, rangeFill y rangeFont de un rango especificado.

El resultado de este conjunto de solicitudes es una tabla con tres celdas con formato como las tres celdas principales de la imagen siguiente.

Tabla de gráfico de Excel con tres celdas en las que se han actualizado las propiedades de fuente, el relleno y el formato.

Ejemplo 1: Alineación y altura de la celda 1

La siguiente solicitud actualiza la alineación vertical, el alto de fila y el alto de columna de la primera celda.

Solicitud

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$A$1')/format
Content-type: application/json

{
  "columnWidth": 135,
  "verticalAlignment": "Top",
  "rowHeight": 49,
  "wrapText": false
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new WorkbookRangeFormat
{
	ColumnWidth = 135d,
	VerticalAlignment = "Top",
	RowHeight = 49d,
	WrapText = false,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Workbook.Worksheets["{workbookWorksheet-id}"].Range().Format.PatchAsync(requestBody);



mgc drives items workbook worksheets range-with-address format patch --address {address-id} --drive-id {drive-id} --drive-item-id {driveItem-id} --workbook-worksheet-id {workbookWorksheet-id} --body '{\
  "columnWidth": 135,\
  "verticalAlignment": "Top",\
  "rowHeight": 49,\
  "wrapText": false\
}\
'



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewWorkbookRangeFormat()
columnWidth := float64(135)
requestBody.SetColumnWidth(&columnWidth) 
verticalAlignment := "Top"
requestBody.SetVerticalAlignment(&verticalAlignment) 
rowHeight := float64(49)
requestBody.SetRowHeight(&rowHeight) 
wrapText := false
requestBody.SetWrapText(&wrapText) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
format, err := graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Workbook().Worksheets().ByWorkbookWorksheetId("workbookWorksheet-id").RangeWithAddress(&address).Format().Patch(context.Background(), requestBody, nil)


const options = {
	authProvider,
};

const client = Client.init(options);

const workbookRangeFormat = {
  columnWidth: 135,
  verticalAlignment: 'Top',
  rowHeight: 49,
  wrapText: false
};

await client.api('/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$A$1')/format')
	.update(workbookRangeFormat);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
    "columnWidth": 135,
    "horizontalAlignment": "General",
    "rowHeight": 49,
    "verticalAlignment": "Top",
    "wrapText": false
}

Ejemplo 2: Estilo, tamaño y color de fuente de la celda 1

La siguiente solicitud actualiza el estilo, el tamaño y el color de la fuente de la primera celda.

Solicitud

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$A$1')/format/font
Content-type: application/json

{
  "bold": true,
  "color": "#4B180E",
  "size": 26
}

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

const workbookRangeFont = {
  bold: true,
  color: '#4B180E',
  size: 26
};

await client.api('/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$A$1')/format/font')
	.update(workbookRangeFont);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
    "bold": true,
    "color": "#4B180E",
    "italic": false,
    "name": "Calibri",
    "size": 26,
    "underline": "None"
}

Ejemplo 3: Color de fondo de la celda 1

La siguiente solicitud actualiza el color de fondo de la primera celda.

Solicitud

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$A$1')/format/fill
Content-type: application/json

{
  "color": "#FF0000"
}

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

const workbookRangeFill = {
  color: '#FF0000'
};

await client.api('/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$A$1')/format/fill')
	.update(workbookRangeFill);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
    "color": "#FF0000"
}

Ejemplo 4: Alineación y altura de la celda 2

La siguiente solicitud actualiza la alineación vertical, la alineación horizontal, el alto de fila y el alto de columna de la segunda celda.

Solicitud

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$B$1')/format
Content-type: application/json

{
  "columnWidth": 135,
  "horizontalAlignment": "Center",
  "verticalAlignment": "Center",
  "rowHeight": 49,
  "wrapText": false
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new WorkbookRangeFormat
{
	ColumnWidth = 135d,
	HorizontalAlignment = "Center",
	VerticalAlignment = "Center",
	RowHeight = 49d,
	WrapText = false,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Workbook.Worksheets["{workbookWorksheet-id}"].Range().Format.PatchAsync(requestBody);



mgc drives items workbook worksheets range-with-address format patch --address {address-id} --drive-id {drive-id} --drive-item-id {driveItem-id} --workbook-worksheet-id {workbookWorksheet-id} --body '{\
  "columnWidth": 135,\
  "horizontalAlignment": "Center",\
  "verticalAlignment": "Center",\
  "rowHeight": 49,\
  "wrapText": false\
}\
'



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewWorkbookRangeFormat()
columnWidth := float64(135)
requestBody.SetColumnWidth(&columnWidth) 
horizontalAlignment := "Center"
requestBody.SetHorizontalAlignment(&horizontalAlignment) 
verticalAlignment := "Center"
requestBody.SetVerticalAlignment(&verticalAlignment) 
rowHeight := float64(49)
requestBody.SetRowHeight(&rowHeight) 
wrapText := false
requestBody.SetWrapText(&wrapText) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
format, err := graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Workbook().Worksheets().ByWorkbookWorksheetId("workbookWorksheet-id").RangeWithAddress(&address).Format().Patch(context.Background(), requestBody, nil)


const options = {
	authProvider,
};

const client = Client.init(options);

const workbookRangeFormat = {
  columnWidth: 135,
  horizontalAlignment: 'Center',
  verticalAlignment: 'Center',
  rowHeight: 49,
  wrapText: false
};

await client.api('/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$B$1')/format')
	.update(workbookRangeFormat);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
    "columnWidth": 135,
    "horizontalAlignment": "Center",
    "rowHeight": 49,
    "verticalAlignment": "Center",
    "wrapText": false
}

Ejemplo 5: Estilo y tamaño de fuente de celda 2

La siguiente solicitud actualiza el estilo de fuente y el tamaño de la segunda celda.

Solicitud

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$B$1')/format/font
Content-type: application/json

{
  "italic": true,
  "size": 26
}

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

const workbookRangeFont = {
  italic: true,
  size: 26
};

await client.api('/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$B$1')/format/font')
	.update(workbookRangeFont);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
    "bold": false,
    "color": "#000000",
    "italic": true,
    "name": "Calibri",
    "size": 26,
    "underline": "None"
}

Ejemplo 6: Color de fondo de la celda 2

La siguiente solicitud actualiza el color de fondo de la segunda celda.

Solicitud

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$B$1')/format/fill
Content-type: application/json

{
  "color": "#00FF00"
}

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

const workbookRangeFill = {
  color: '#00FF00'
};

await client.api('/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$B$1')/format/fill')
	.update(workbookRangeFill);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
    "color": "#00FF00"
}

Ejemplo 7: Alineación y altura de la celda 3

La siguiente solicitud actualiza la alineación horizontal, la alineación vertical, el alto de fila y el alto de columna de la tercera celda.

Solicitud

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$C$1')/format
Content-type: application/json

{
  "columnWidth": 135,
  "horizontalAlignment": "Right",
  "verticalAlignment": "Top",
  "rowHeight": 49,
  "wrapText": false
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new WorkbookRangeFormat
{
	ColumnWidth = 135d,
	HorizontalAlignment = "Right",
	VerticalAlignment = "Top",
	RowHeight = 49d,
	WrapText = false,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Workbook.Worksheets["{workbookWorksheet-id}"].Range().Format.PatchAsync(requestBody);



mgc drives items workbook worksheets range-with-address format patch --address {address-id} --drive-id {drive-id} --drive-item-id {driveItem-id} --workbook-worksheet-id {workbookWorksheet-id} --body '{\
  "columnWidth": 135,\
  "horizontalAlignment": "Right",\
  "verticalAlignment": "Top",\
  "rowHeight": 49,\
  "wrapText": false\
}\
'



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewWorkbookRangeFormat()
columnWidth := float64(135)
requestBody.SetColumnWidth(&columnWidth) 
horizontalAlignment := "Right"
requestBody.SetHorizontalAlignment(&horizontalAlignment) 
verticalAlignment := "Top"
requestBody.SetVerticalAlignment(&verticalAlignment) 
rowHeight := float64(49)
requestBody.SetRowHeight(&rowHeight) 
wrapText := false
requestBody.SetWrapText(&wrapText) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
format, err := graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Workbook().Worksheets().ByWorkbookWorksheetId("workbookWorksheet-id").RangeWithAddress(&address).Format().Patch(context.Background(), requestBody, nil)


const options = {
	authProvider,
};

const client = Client.init(options);

const workbookRangeFormat = {
  columnWidth: 135,
  horizontalAlignment: 'Right',
  verticalAlignment: 'Top',
  rowHeight: 49,
  wrapText: false
};

await client.api('/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$C$1')/format')
	.update(workbookRangeFormat);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
    "columnWidth": 135,
    "horizontalAlignment": "Right",
    "rowHeight": 49,
    "verticalAlignment": "Top",
    "wrapText": false
}

Ejemplo 8: Estilo, tamaño y color de fuente de la celda 3

La solicitud siguiente actualiza el estilo, el tamaño y el color de la fuente de la tercera celda.

Solicitud

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$C$1')/format/font
Content-type: application/json

{
  "underline": "Single",
  "color": "#FFFFFF",
  "size": 26
}

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

const workbookRangeFont = {
  underline: 'Single',
  color: '#FFFFFF',
  size: 26
};

await client.api('/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$C$1')/format/font')
	.update(workbookRangeFont);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
    "bold": false,
    "color": "#FFFFFF",
    "italic": false,
    "name": "Calibri",
    "size": 26,
    "underline": "Single"
}

Ejemplo 9: Color de fondo de la celda 3

La siguiente solicitud actualiza el color de fondo de la tercera celda.

Solicitud

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$C$1')/format/fill
Content-type: application/json

{
  "color": "#0000FF"
}

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

const workbookRangeFill = {
  color: '#0000FF'
};

await client.api('/me/drive/items/{id}/workbook/worksheets/Sheet1/range(address='$C$1')/format/fill')
	.update(workbookRangeFill);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-type: application/json

{
    "color": "#0000FF"
}

Compartir a través de

Actualización de un formato de rango en Excel

Ejemplo 1: Alineación y altura de la celda 1

Solicitud

Respuesta

Ejemplo 2: Estilo, tamaño y color de fuente de la celda 1

Solicitud

Respuesta

Ejemplo 3: Color de fondo de la celda 1

Solicitud

Respuesta

Ejemplo 4: Alineación y altura de la celda 2

Solicitud

Respuesta

Ejemplo 5: Estilo y tamaño de fuente de celda 2

Solicitud

Respuesta

Ejemplo 6: Color de fondo de la celda 2

Solicitud

Respuesta

Ejemplo 7: Alineación y altura de la celda 3

Solicitud

Respuesta

Ejemplo 8: Estilo, tamaño y color de fuente de la celda 3

Solicitud

Respuesta

Ejemplo 9: Color de fondo de la celda 3

Solicitud

Respuesta

Comentarios

Recursos adicionales

Compartir a través de

Actualización de un formato de rango en Excel

Ejemplo 1: Alineación y altura de la celda 1

Solicitud

Respuesta

Ejemplo 2: Estilo, tamaño y color de fuente de la celda 1

Solicitud

Respuesta

Ejemplo 3: Color de fondo de la celda 1

Solicitud

Respuesta

Ejemplo 4: Alineación y altura de la celda 2

Solicitud

Respuesta

Ejemplo 5: Estilo y tamaño de fuente de celda 2

Solicitud

Respuesta

Ejemplo 6: Color de fondo de la celda 2

Solicitud

Respuesta

Ejemplo 7: Alineación y altura de la celda 3

Solicitud

Respuesta

Ejemplo 8: Estilo, tamaño y color de fuente de la celda 3

Solicitud

Respuesta

Ejemplo 9: Color de fondo de la celda 3

Solicitud

Respuesta

Contenido relacionado

Comentarios

Recursos adicionales