Skip to content

Commit 1d2d7b6

Browse files
VanMSFTVanMSFT
committed
docs: Fix JDBC prepareStatement method overload documentation structure
- Rename preparestatement-method-java-lang-string.md to preparestatement-method-java-lang-string-int-array.md (correct file for int[] overload) - Create new preparestatement-method-java-lang-string.md with correct String-only overload documentation - Update preparestatement-method-sqlserverconnection.md to link to correct int-array file - Add missing prepareStatement(String, int[]) entry to toc.yml Addresses product team feedback in PR #36371 - generation process didn't handle array parameter types correctly and overwrote one file instead of creating separate files for each overload.
1 parent 9de65d6 commit 1d2d7b6

4 files changed

Lines changed: 93 additions & 40 deletions

File tree

‎docs/connect/jdbc/reference/preparestatement-method-java-lang-string-int-array.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: "prepareStatement Method (java.lang.String, int[])"
3+
description: "prepareStatement Method (java.lang.String, int[])"
4+
author: David-Engel
5+
ms.author: davidengel
6+
ms.date: "01/19/2017"
7+
ms.service: sql
8+
ms.subservice: connectivity
9+
ms.topic: reference
10+
apilocation: "sqljdbc.jar"
11+
apiname: "SQLServerConnection.prepareStatement (java.lang.String, int[])"
12+
apitype: "Assembly"
13+
---
14+
# prepareStatement Method (java.lang.String, int[])
15+
[!INCLUDE[Driver_JDBC_Download](../../../includes/driver_jdbc_download.md)]
16+
17+
Creates a [SQLServerPreparedStatement](../../../connect/jdbc/reference/sqlserverpreparedstatement-class.md) object for sending parameterized SQL statements to the database, and that is capable of returning the auto-generated keys designated by the given array.
18+
19+
## Syntax
20+
21+
```
22+
23+
public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
24+
int[] columnIndexes)
25+
```
26+
27+
#### Parameters
28+
*sql*
29+
30+
A **String** that contains a SQL statement.
31+
32+
*columnIndexes*
33+
34+
An array of ints.
35+
36+
## Return Value
37+
A PreparedStatement object.
38+
39+
## Exceptions
40+
[SQLServerException](../../../connect/jdbc/reference/sqlserverexception-class.md)
41+
42+
## Remarks
43+
This prepareStatement method is specified by the prepareStatement method in the java.sql.Connection interface.
44+
45+
## See Also
46+
[prepareStatement Method (SQLServerConnection)](../../../connect/jdbc/reference/preparestatement-method-sqlserverconnection.md)
47+
[SQLServerConnection Members](../../../connect/jdbc/reference/sqlserverconnection-members.md)
48+
[SQLServerConnection Class](../../../connect/jdbc/reference/sqlserverconnection-class.md)
49+
50+

‎docs/connect/jdbc/reference/preparestatement-method-java-lang-string.md‎

Lines changed: 40 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,51 @@
11
---
2-
title: "prepareStatement Method (java.lang.String, int[])"
3-
description: "prepareStatement Method (java.lang.String, int[])"
2+
title: "prepareStatement Method (java.lang.String)"
3+
description: "prepareStatement Method (java.lang.String)"
44
author: David-Engel
55
ms.author: davidengel
6-
ms.date: "01/19/2017"
6+
ms.date: "01/22/2026"
77
ms.service: sql
88
ms.subservice: connectivity
99
ms.topic: reference
1010
apilocation: "sqljdbc.jar"
11-
apiname: "SQLServerConnection.prepareStatement (java.lang.String, int[])"
11+
apiname: "SQLServerConnection.prepareStatement (java.lang.String)"
1212
apitype: "Assembly"
13+
ai-usage: ai-assisted
1314
---
14-
# prepareStatement Method (java.lang.String, int[])
15+
# prepareStatement Method (java.lang.String)
16+
1517
[!INCLUDE[Driver_JDBC_Download](../../../includes/driver_jdbc_download.md)]
1618

17-
Creates a [SQLServerPreparedStatement](../../../connect/jdbc/reference/sqlserverpreparedstatement-class.md) object for sending parameterized SQL statements to the database, and that is capable of returning the auto-generated keys designated by the given array.
18-
19-
## Syntax
20-
21-
```
22-
23-
public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
24-
int[] columnIndexes)
25-
```
26-
27-
#### Parameters
28-
*sql*
29-
30-
A **String** that contains a SQL statement.
31-
32-
*columnIndexes*
33-
34-
An array of ints.
35-
36-
## Return Value
37-
A PreparedStatement object.
38-
39-
## Exceptions
40-
[SQLServerException](../../../connect/jdbc/reference/sqlserverexception-class.md)
41-
42-
## Remarks
43-
This prepareStatement method is specified by the prepareStatement method in the java.sql.Connection interface.
44-
45-
## See Also
46-
[prepareStatement Method (SQLServerConnection)](../../../connect/jdbc/reference/preparestatement-method-sqlserverconnection.md)
47-
[SQLServerConnection Members](../../../connect/jdbc/reference/sqlserverconnection-members.md)
48-
[SQLServerConnection Class](../../../connect/jdbc/reference/sqlserverconnection-class.md)
49-
50-
19+
Creates a [SQLServerPreparedStatement](../../../connect/jdbc/reference/sqlserverpreparedstatement-class.md) object for sending parameterized SQL statements to the database.
20+
21+
## Syntax
22+
23+
```java
24+
public java.sql.PreparedStatement prepareStatement(java.lang.String sql)
25+
```
26+
27+
#### Parameters
28+
29+
*sql*
30+
31+
A **String** that contains a SQL statement.
32+
33+
## Return Value
34+
35+
A PreparedStatement object.
36+
37+
## Exceptions
38+
39+
[SQLServerException](../../../connect/jdbc/reference/sqlserverexception-class.md)
40+
41+
## Remarks
42+
43+
This prepareStatement method is specified by the prepareStatement method in the java.sql.Connection interface.
44+
45+
## Related content
46+
47+
- [prepareStatement Method (SQLServerConnection)](../../../connect/jdbc/reference/preparestatement-method-sqlserverconnection.md)
48+
- [SQLServerConnection Members](../../../connect/jdbc/reference/sqlserverconnection-members.md)
49+
- [SQLServerConnection Class](../../../connect/jdbc/reference/sqlserverconnection-class.md)
50+
51+

‎docs/connect/jdbc/reference/preparestatement-method-sqlserverconnection.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ apitype: "Assembly"
2222
|----------|-----------------|
2323
|[prepareStatement (java.lang.String)](../../../connect/jdbc/reference/preparestatement-method-java-lang-string.md)|Creates a [SQLServerPreparedStatement](../../../connect/jdbc/reference/sqlserverpreparedstatement-class.md) object for sending parameterized SQL statements to the database.|
2424
|[prepareStatement (java.lang.String, int)](../../../connect/jdbc/reference/preparestatement-method-java-lang-string-int.md)|Creates a [SQLServerPreparedStatement](../../../connect/jdbc/reference/sqlserverpreparedstatement-class.md) object for sending parameterized SQL statements to the database, and has the capability to retrieve auto-generated keys.|
25-
|[prepareStatement (java.lang.String, int[])](../../../connect/jdbc/reference/preparestatement-method-java-lang-string.md)|Creates a [SQLServerPreparedStatement](../../../connect/jdbc/reference/sqlserverpreparedstatement-class.md) object for sending parameterized SQL statements to the database, and that is capable of returning the auto-generated keys that are designated by the given array.|
25+
|[prepareStatement (java.lang.String, int[])](../../../connect/jdbc/reference/preparestatement-method-java-lang-string-int-array.md)|Creates a [SQLServerPreparedStatement](../../../connect/jdbc/reference/sqlserverpreparedstatement-class.md) object for sending parameterized SQL statements to the database, and that is capable of returning the auto-generated keys that are designated by the given array.|
2626
|[prepareStatement (java.lang.String, int, int)](../../../connect/jdbc/reference/preparestatement-method-java-lang-string-int-int.md)|Creates a [SQLServerPreparedStatement](../../../connect/jdbc/reference/sqlserverpreparedstatement-class.md) object that generates [SQLServerResultSet](../../../connect/jdbc/reference/sqlserverresultset-class.md) objects with the given type and concurrency.|
2727
|[prepareStatement (java.lang.String, int, int, int)](../../../connect/jdbc/reference/preparestatement-method-java-lang-string-int-int-int.md)|Creates a [SQLServerPreparedStatement](../../../connect/jdbc/reference/sqlserverpreparedstatement-class.md) object that generates [SQLServerResultSet](../../../connect/jdbc/reference/sqlserverresultset-class.md) objects with the given type, concurrency, and holdability.|
2828
|[prepareStatement (java.lang.String, java.lang.String[])](../../../connect/jdbc/reference/preparestatement-method-java-lang-string-java-lang-string.md)|Creates a [SQLServerPreparedStatement](../../../connect/jdbc/reference/sqlserverpreparedstatement-class.md) object for sending parameterized SQL statements to the database.|

‎docs/connect/toc.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -923,6 +923,8 @@
923923
href: ../connect/jdbc/reference/preparestatement-method-java-lang-string.md
924924
- name: prepareStatement Method (java.lang.String, int)
925925
href: ../connect/jdbc/reference/preparestatement-method-java-lang-string-int.md
926+
- name: prepareStatement Method (java.lang.String, int[])
927+
href: ../connect/jdbc/reference/preparestatement-method-java-lang-string-int-array.md
926928
- name: prepareStatement Method (java.lang.String, int, int)
927929
href: ../connect/jdbc/reference/preparestatement-method-java-lang-string-int-int.md
928930
- name: prepareStatement Method (java.lang.String, int, int, int)

0 commit comments

Comments
 (0)