更新 RangeBorder
命名空间:microsoft.graph
更新 rangeborder 对象的属性。
Permissions
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。
| 权限类型 |
权限(从最低特权到最高特权) |
| 委派(工作或学校帐户) |
Files.ReadWrite |
| 委派(个人 Microsoft 帐户) |
不支持。 |
| 应用程序 |
不支持。 |
HTTP 请求
PATCH /me/drive/items/{id}/workbook/names/{name}/range/format/borders/{sideIndex}
PATCH /me/drive/root:/{item-path}:/workbook/names/{name}/range/format/borders/{sideIndex}
PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/range(address='<address>')/format/borders/{sideIndex}
PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/range(address='<address>')/format/borders/{sideIndex}
PATCH /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/range/format/borders/{sideIndex}
PATCH /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/range/format/borders/{sideIndex}
| 名称 |
说明 |
| Authorization |
Bearer {token}。必需。 |
| Workbook-Session-Id |
确定是否保留更改的工作簿会话 ID。可选。 |
请求正文
在请求正文中,提供应更新的相关字段的值。请求正文中不包括的现有属性将保留其以前的值,或根据对其他属性值的更改重新计算。为了获得最佳性能,不应包括尚未更改的现有值。
| 属性 |
类型 |
Description |
| color |
string |
表示窗体 #RRGGBB(例如“FFA500”)的边框线条颜色或作为已命名的 HTML 颜色(例如“orange”)的 HTML 颜色代码。 |
| style |
string |
线条样式的常量之一,指定边框的线条样式。 可能的值是 None Continuous :、、、、、、、。 Dash DashDot DashDotDot Dot Double SlantDashDot |
| weight |
string |
指定区域周围的边框的粗细。 可能的值包括 Hairline、Thin、Medium、Thick。 |
响应
如果成功,此方法在响应 200 OK 正文中返回 响应代码和更新的 WorkbookRangeBorder 对象。
示例
请求
下面是一个请求示例。
PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/range/format/borders/{sideIndex}
Content-type: application/json
{
"color": "color-value",
"style": "style-value",
"sideIndex": "sideIndex-value",
"weight": "weight-value"
}
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var workbookRangeBorder = new WorkbookRangeBorder
{
Color = "color-value",
Style = "style-value",
SideIndex = "sideIndex-value",
Weight = "weight-value"
};
await graphClient.Me.Drive.Items["{driveItem-id}"].Workbook.Names["{workbookNamedItem-id}"]
.Range().Format.Borders["{workbookRangeBorder-id}"]
.Request()
.UpdateAsync(workbookRangeBorder);
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档。
const options = {
authProvider,
};
const client = Client.init(options);
const workbookRangeBorder = {
color: 'color-value',
style: 'style-value',
sideIndex: 'sideIndex-value',
weight: 'weight-value'
};
await client.api('/me/drive/items/{id}/workbook/names/{name}/range/format/borders/{sideIndex}')
.update(workbookRangeBorder);
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档。
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/drive/items/{id}/workbook/names/{name}/range/format/borders/{sideIndex}"]]];
[urlRequest setHTTPMethod:@"PATCH"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
MSGraphWorkbookRangeBorder *workbookRangeBorder = [[MSGraphWorkbookRangeBorder alloc] init];
[workbookRangeBorder setColor:@"color-value"];
[workbookRangeBorder setStyle:@"style-value"];
[workbookRangeBorder setSideIndex:@"sideIndex-value"];
[workbookRangeBorder setWeight:@"weight-value"];
NSError *error;
NSData *workbookRangeBorderData = [workbookRangeBorder getSerializedDataWithError:&error];
[urlRequest setHTTPBody:workbookRangeBorderData];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
//Request Completed
}];
[meDataTask execute];
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档。
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
WorkbookRangeBorder workbookRangeBorder = new WorkbookRangeBorder();
workbookRangeBorder.color = "color-value";
workbookRangeBorder.style = "style-value";
workbookRangeBorder.sideIndex = "sideIndex-value";
workbookRangeBorder.weight = "weight-value";
graphClient.me().drive().items("{id}").workbook().names("{name}")
.range().format().borders("{sideIndex}")
.buildRequest()
.patch(workbookRangeBorder);
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档。
响应
这是一个示例响应。注意:为提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "id-value",
"color": "color-value",
"style": "style-value",
"sideIndex": "sideIndex-value",
"weight": "weight-value"
}